A small cli application to convert MacOS's heic dynamic wallpaper images to dynamic wallpapers usable in the GNOME desktop environment.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Johannes Wünsche e150ba848e
(cargo-release) start next development iteration 0.1.4-alpha.0
4 months ago
.github/workflows Adjust workflow for release 5 months ago
src Give textual errors if paths are invalid 5 months ago
.gitignore Update gitignore 6 months ago
Cargo.lock (cargo-release) start next development iteration 0.1.4-alpha.0 4 months ago
Cargo.toml (cargo-release) start next development iteration 0.1.4-alpha.0 4 months ago
LICENSE.md Add License and metadata 5 months ago
README.md Add resource link README 5 months ago
concept.md Update README 5 months ago


heic-to-dynamic-gnome-wallpaper 🌅 🎞 🌇

This project offers a cli to convert MacOS's dynamic wallpaper stored in .heic image containers to dynamic wallpaper definitions usable in GNOME.

Both solar position and time based wallpaper definitions are supported. Although due to the nature of the gnome wallpapers, solar based wallpapers will be transferred to a time based division, approximated from the solar position defined for each image.

🧰 Usage

Since most options are dictated by the image information, tweakable options are sparse. All you need to do is specify the path to the image you want to convert.
Optionally you can specify a path under which the new images extracted from the heic are to be stored including the xml specification for GNOME.


    heic-to-gnome-xml-wallpaper [OPTIONS] <IMAGE>

    -h, --help
            Prints help information

    -V, --version
            Prints version information

    -d, --dir <DIR>
            Specifies into which directory created images should be written to. Default is the parent directory of the
            given image.

            Image which should be transformed

📦 Installation

You may either use the provided pre-built binary on this repository. Or build the project yourself on your local machine, you'll need a working rust toolchain in this case, check out the instructions here.

Pre-built binaries

$ mkdir -p ~/.local/bin
$ curl https://github.com/jwuensche/heic-to-dynamic-gnome-wallpaper/releases/download/v0.1.1/heic-to-dynamic-gnome-wallpaper --output heic-to-dynamic-gnome-wallpaper
$ chmod +x heic-to-dynamic-gnome-wallpaper
$ ./heic-to-dynamic-gnome-wallpaper /path/to/some/image

Local via cargo install

$ cargo install heic-to-dynamic-gnome-wallpaper

Local manual

$ git clone https://github.com/jwuensche/heic-to-dynamic-gnome-wallpaper
$ cd heic-to-dynamic-gnome-wallpaper
$ cargo install --path .
$ # OR
$ cargo build --release