Enhanced the ReadMe

pull/1/head
Nickiel12 3 years ago committed by GitHub
parent 1941b2e3a9
commit ee70774eb3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -6,31 +6,43 @@ A minimalist checklist menu for [rofi](/davatorium/rofi).
## Installation ## Installation
The icons in rofi-checklist require the usage of [Nerd Fonts](https://www.nerdfonts.com/). Make sure you have [Nerd Fonts](https://www.nerdfonts.com/) installed for the icons to work.
### Arch Linux ### Arch Linux
rofi-checklist is available on the AUR under [rofi-checklist-git](https://aur.archlinux.org/packages/rofi-checklist-git). If you have the AUR helper [yay](/Jguer/yay) installed, you can easily install rofi-checklist on your system using the following command: rofi-checklist is available on the AUR, [rofi-checklist-git](https://aur.archlinux.org/packages/rofi-checklist-git).
If you have the AUR helper [yay](/Jguer/yay) installed, you can easily install rofi-checklist on your system using the following command:
```SH ```SH
yay -S rofi-checklist-git yay -S rofi-checklist-git
``` ```
If you didn't have rofi installed, it will now be on your system as a dependency of rofi-checklist. [rofi](/davatorium/rofi) is a prequisite, and will be installed if it is not already.
This is my first package on the AUR, so my apologies if I've made any mistakes packaging it! This is my first package on the AUR, so my apologies if I've made any mistakes packaging it!
### Other Linux distros ### Other Linux distros
After installing rofi, copy [rofi-checklist.sh](rofi-checklist.sh) to `/usr/bin/rofi-checklist`. Ensure rofi is installed, then clone this repository,
```SH
git clone https://github.com/ElnuDev/rofi-checklist.git
```
and copy [rofi-checklist.sh](rofi-checklist.sh) to `/usr/bin/rofi-checklist`.
Alternatively you can curl/wget the file straight to `/usr/bin/rofi-checklist` and add the executable flag manually.
## Usage ## Usage
rofi-checklist is best used when mapped to a keybinding. For example, in i3, you can map it `Alt`+`T` (**T** for **T**asks) by adding `bindsym Mod1+T exec rofi-checklist` to your `~/.config/i3/config` file. Rofi-checklist is best when mapped to a keybinding. Simply create a keybind that calls `rofi-checklist`.
For example, in i3, you can map it `Alt`+`T` (**T** for **T**asks) by adding `bindsym Mod1+T exec rofi-checklist` to your `~/.config/i3/config` file.
Rofi-checklist is very simple to use. Once launched, it shows a list of tasks. If you press enter on an incomplete task, it is marked as complete. Selecting it again removes it from the list.
In terms of usage, rofi-checklist is very simple to use. When launched, it shows a list of currently available tasks. If you select an incomplete task, it gets marked as completed, and selecting it again removes it from the list. There are two actions at the top of the list, one for clearing all tasks and one for clearing only completed tasks. If you want to add a new task, simply type in a task name that doesn't exist yet and press enter. There are two actions at the top of the list, one for clearing all tasks and one for clearing only completed tasks. To add a new task, simply type a task name that doesn't exist yet and press enter.
rofi-checklist stores the checklist in `~/.rofi-checklist` in a markdown-compliant format, such as the following: Rofi-checklist stores the checklist in `~/.rofi-checklist` as a markdown-compliant format, such as the following:
```MD ```MD
- [x] Consume the blood of my enemies - [x] Consume the blood of my enemies
@ -38,4 +50,4 @@ rofi-checklist stores the checklist in `~/.rofi-checklist` in a markdown-complia
- [ ] Go to bed - [ ] Go to bed
``` ```
This is useful because it allows the checklist to be used within markdown editors. For example, if you make a symbolic link from `~/.rofi-checklist` to somewhere in your [Obsidian](https://obsidian.md/) vault, then this creates a nice integration into your knowledge management software. If there's interest, support for more checklist file sources might be added in the future. This allows the checklist file to be used within other markdown editors. For example, you can make a symbolic link from `~/.rofi-checklist` to somewhere in your [Obsidian](https://obsidian.md/) vault - allowing a nice integration into your knowledge management software. If there's interest, support for configurable/multiple checklist file sources might be added in the future.