🌹 roseate

_{A small and simple but fancy image viewer built with Rust that's cross-platform. VERY WIP!}

Caution

This project is HEAVILY a work in progress, hence it may crash or harm your system. Give it time to mature. Github issues are very welcome. 🤝

🛠️ Installation

As Roseate is in heavy development I won't offer packages and binaries yet so you'll need to compile the application from source.

🏗 Build from source

Prerequisites:

• Rust and Cargo (I used 1.80.0 for development).

1. Clone the repo.

git clone https://github.com/cloudy-org/roseate
cd roseate

2. Pull some submodules.

git submodule update --init --recursive

(you can skip that step as the cirrus toolkit is not needed right now)

⚙️ For Development

At this stage, for development, you would just run cargo run. If you would like to install it to your system continue ahead to the next section.

4. Run dev binary.

cargo run

To run Roseate in development with an image, append -- and pass an image path after like so:

cargo run -- ./anime_girl.png

🎀 Install into your system.

Installing it to your system I advise you use GNU Make or else copy the commands from the "Makefile" (you will need to install Make if you haven't already).

4. Build the release binary.

make

5. Install to your system.

sudo make install

6. Then the roseate binary will be available in your terminal.

roseate

Open an image by passing its path.

roseate ./anime_girls.png

You might want to also set the binary at /usr/bin/roseate as your default image viewer so double clicking on images calls it. You can look up how to perform that for your desktop environment or OS.