Skip to content

Commit d737080

Browse files
authored
Initial README.md Update
1 parent f8e1a0e commit d737080

File tree

1 file changed

+36
-2
lines changed

1 file changed

+36
-2
lines changed

README.md

+36-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,36 @@
1-
# rice-manager
2-
A GTK3.0 Dotfile Management tool for Linux Rices
1+
# Rice Manager: Manage and Apply Rices
2+
![](https://github.com/Narmis-E/rice-manager/blob/main/myapp.png) \
3+
Rice Manager is a GTK3 dotfile management tool for linux rices. It allows you to add, remove and apply rices on the fly with a straight-forward interface.
4+
5+
## What can it do?
6+
You can add and remove dotfiles in the add rice menu, specify a name for your rice and then apply or remove added rices on the view rice menu. Packaging for flatpak is currently WIP (the FileChooserDialog() for the user's home directory is currently borked), so the only current availability is for AppImages, although I intent to expand and add support for other packge management systems. \
7+
Rice manager abides by the laws of ricing philosophy, where the user's home directory shouldn't be modified and the configuration for various window managers and applications should all be sourced from a singular location. Rice Manager is very useful for this reason, as implementing control over rices ensures that configs can't conflict and they don't need to be archived.
8+
9+
## Why Though?
10+
Having created multiple linux rices myself, I noticed that is is quite an annoying process to manually switch between them and I also wanted an excuse to try and develop a actually useful program, with GTK comming to mind.
11+
I originally wanted to create this as a TUI with pure bash or C++, but I decided on GTK because A: it looks cool and B: It works with python which has much nicer os parsing and filesystem libraries built in compared to C++.
12+
13+
## Local Install
14+
15+
Install dependencies:
16+
```
17+
pip3 install PyGObject
18+
```
19+
20+
Clone the repo:
21+
```
22+
git clone https://github.com/Narmis-E/rice-manager && cd rice-manager
23+
```
24+
25+
Run the program
26+
```
27+
python3 rice-manager.py
28+
```
29+
30+
### Todo:
31+
- [ ] Add tickbox for removing symlinked rice files on view rice screen
32+
- [ ] Add CLI arguments for Rice Manager
33+
- [ ] Add rices to the main menu
34+
- [ ] Add a duplicate rice button
35+
- [ ] Add flatpak package/any other package management system
36+

0 commit comments

Comments
 (0)