You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-[libxrandr](https://archlinux.org/packages/extra/x86_64/libxrandr/) (required by [display-info](https://crates.io/crates/display-info) for smart downsampling)
34
+
-[xdg-desktop-portal](https://github.com/flatpak/xdg-desktop-portal) (required by [rfd](https://docs.rs/rfd/latest/rfd/) for file dialog)
35
+
36
+
All of these deps are required on Linux. However they are *common* x11 / wayland dependencies so you most likely already have them installed.
33
37
34
38
1. Clone the repo.
35
39
```sh
@@ -41,10 +45,37 @@ cd roseate
41
45
git submodule update --init --recursive
42
46
```
43
47
48
+
#### 🎀 Install into your system.
49
+
Installing it to your system I advise you use GNU Make or else copy the commands from the "[Makefile](./Makefile)" (you will need to install Make if you haven't already).
50
+
If you would like to run roseate for development continue ahead to the [next section](#%EF%B8%8F-for-development).
51
+
52
+
3. Build the release binary.
53
+
```sh
54
+
make
55
+
```
56
+
4. Install to your system.
57
+
```sh
58
+
sudo make install
59
+
```
60
+
5. Then the `roseate` binary will be available in your terminal.
61
+
```sh
62
+
roseate
63
+
```
64
+
65
+
Open an image by passing its path.
66
+
```sh
67
+
roseate ./anime_girls.png
68
+
```
69
+
You might want to also set the binary at ``/usr/bin/roseate`` as your default image viewer so double clicking on images calls it.
70
+
You can look up how to perform that for your desktop environment or operating system but on many popular Linux desktop environments, the [`roseate.desktop`](https://github.com/cloudy-org/roseate/blob/main/assets/roseate.desktop) file that is now installed on your system is your friend. 😉
71
+
44
72
#### ⚙️ For Development
45
-
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](#-install-into-your-system).
73
+
> [!WARNING]
74
+
> Building a development build WILL SIGNIFICANTLY KILL performance! Read more [here](https://github.com/cloudy-org/roseate/blob/6e7e638997110af0149f06ceadb87c3ec088cf84/Cargo.toml#L48-L53).
46
75
47
-
4. Run dev binary.
76
+
Now for development, you would just run ``cargo run``.
77
+
78
+
3. Run dev binary.
48
79
```sh
49
80
cargo run
50
81
```
@@ -68,28 +99,6 @@ RUST_LOG=DEBUG cargo run -- ./anime_girl.png
68
99
... (truncated for the sanity of this readme)
69
100
```
70
101
71
-
#### 🎀 Install into your system.
72
-
Installing it to your system I advise you use GNU Make or else copy the commands from the "[Makefile](./Makefile)" (you will need to install Make if you haven't already).
73
-
74
-
4. Build the release binary.
75
-
```sh
76
-
make
77
-
```
78
-
5. Install to your system.
79
-
```sh
80
-
sudo make install
81
-
```
82
-
6. Then the `roseate` binary will be available in your terminal.
83
-
```sh
84
-
roseate
85
-
```
86
-
87
-
Open an image by passing its path.
88
-
```sh
89
-
roseate ./anime_girls.png
90
-
```
91
-
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.
0 commit comments