Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 3.49 KB

README.md

File metadata and controls

93 lines (66 loc) · 3.49 KB
Raw

BlurThing 🌄

Cross-platform application for generating and customizing BlurHashes from
images, with extensive controls for image manipulation.


Made with Iced

Basic Usage

  1. Open an image file with the open file dialog
  2. Adjust the image manipulation parameters to your liking
  3. Copy the blur hash to the clipboard, or alternatively export the blurred rastered image

Application Demo

How is this useful?

BlurHashes are typically used in scenarios where you want to display a placeholder image while it is being loaded.

If that is your use case, this application can be a quick way to generate a BlurHash for your images. (for testing, or if you are lazy and didn't integrate the BlurHash generation in your backend)

However, BlurThing can be used to manipulate an input image and export a blurred version of it. With the right parameters you can create some cool f**king abstract wallpapers that look like they came straight from the iPhone 19.

BlurThing can be helpful, or it can be a fun toy. It's up to you.

Getting Started

The easiest way to run BlurThing is by using the pre-built binaries available in the releases page.

From there, you want to download the appropriate installer for your operating system and architecture.

Note: If you are using macOS, you may be greeted with a "BlurThing can't be opened" message. This is due to the application currently not being signed.

To open it anyway, you can right-click on the application and select Open.

Hotkeys

Some hotkeys are available for faster interaction:

  • Ctrl + O -> shows the open file dialog
  • Ctrl + C -> copies the BlurHash to the clipboard
  • Ctrl + S -> exports the current blurred image to a file
  • Ctrl + Z -> undo the last modification
  • Ctrl + Shift + Z -> redo the last modification

Note: On macOS, replace Ctrl with Command

Build and Run

To compile the main executable, run:

cargo run --bin blurhash --release

Packaging and Bundling

With the help of the tauri-bundler crate, it is possible to automagically create OS-specific distribution bundles.

To build and bundle the application, run:

cargo xtask bundle --release

Future Plans and Ideas

  • Add new image manipulation filters (e.g. rotation, flip, waves???, distort???)
  • Improve the export UX, allowing the user to choose the output resolution
  • Implement an "I feel lucky" button that loads a random image from the internet (what could go wrong anyway?)