diff options
author | Orangerot <purple@orangerot.dev> | 2023-04-10 22:59:49 +0200 |
---|---|---|
committer | Orangerot <purple@orangerot.dev> | 2023-04-10 22:59:49 +0200 |
commit | b0a8acd23c0a4ac5058dd8ea0c7dcb422929ebf1 (patch) | |
tree | 731342239a754b8f2133dda7f144e2d544ffaccb | |
parent | af9d2c446ea5d8ed9d7d13b364f517abcaeb0ae5 (diff) |
added README with installation instructions
-rw-r--r-- | README.md | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..56e4677 --- /dev/null +++ b/README.md @@ -0,0 +1,72 @@ +# desktop-icon + +> Show Files from a Directory on the Desktop + +## Features + +- [X] Show content from a folder as Icons on the Desktop +- [X] Use xdg_user_dir to use the default desktop directory +- [X] Start default application for the active file +- [X] Update the Icons on changes to the directory (added/removed files) +- [ ] Dropping files on the Desktop +- [ ] Dragging files from the Desktop +- [ ] Multi-Monitor Support +- [ ] Thumbnails for Images/Documents +- [ ] Sort Rows of List Store based on Name/Type/Date +- [ ] Context-Menu for creating files + +## Supported Desktops + +> Quoted from [gtk-layer-shell](https://github.com/wmww/gtk-layer-shell) + +This application only works on Wayland, and only on Wayland compositors that +support the Layer Shell protocol. Layer shell **is supported** on: +- wlroots based compositors (such as **Sway**) +- Mir-based compositors (some may not enable the protocol by default and require + `--add-wayland-extension zwlr_layer_shell_v1`) + +Layer shell **is not supported** on: +- Gnome-on-Wayland +- Any X11 desktop + +## Getting Started + +### Dependencies + +- gtk+-3.0 +- gtk-layer-shell + +Arch +```sh +sudo pacman -S gtk3 gtk-layer-shell +``` + +### Installing + +```sh +git clone https://github.com/Geronymos/desktop-icons +cd desktop-icons +make +sudo make install +``` + +Uninstall +```sh +sudo make uninstall +``` + +### Development + +Dependencies +- bear + +To have warnings and autocompletion with clangd in Vim you can generate the +`compile-commands.json` with +```sh +make clangd +``` + +## License + +This project is licensed under the GPL-3 License - see the `LICENSE` file for details + |