RapidMenu/README.md

90 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

2024-01-11 16:24:53 +01:00
# RapidMenu
2024-01-19 15:49:42 +01:00
Utilize configuration files to create runner scripts.
# Requirements
2024-01-24 01:20:28 +01:00
- cpptoml
- tomlplusplus
2024-01-19 15:49:42 +01:00
- a runner like rofi, dmenu etc
# Installing
2024-05-30 11:15:11 +02:00
From source:
2024-01-19 15:49:42 +01:00
```
make all
sudo make install
```
2024-01-26 17:24:49 +01:00
2024-05-30 11:15:11 +02:00
Using rpm:
```
make all
cd build
cpack -G RPM
sudo rpm -i *.rpm
```
Using deb:
```
make all
cd build
cpack -G deb
sudo dpkg -i *.deb
```
2024-07-28 12:28:59 +02:00
Using PKGBUILD:
```
makepkg -si PKGBUILD
```
2024-01-19 15:49:42 +01:00
# Usage
2024-01-26 17:24:49 +01:00
2024-01-19 15:49:42 +01:00
## Help message
```
usage: RapidMenu [flags] [<command> [args]]
LISTING COMMANDS:
-c: To specify which config to use.
-b: Make a executable out of a config.
```
2024-01-26 17:24:49 +01:00
### You will need to first setup the config dir
To do that you just need to, use this command.
```
RapidMenu
```
And it should say "Created /home/$USER/.config/RapidMenu".
2024-01-26 17:24:49 +01:00
2024-01-19 15:49:42 +01:00
### How to use (-c)
If you want to open a configuration, just use this command.
```
RapidMenu -c [config]
```
You should put the config files in the config dir. So, if you want
2024-01-25 15:36:39 +01:00
to make a dashboard, then call it dashboard.conf. For games, use games.conf etc.
2024-01-26 17:24:49 +01:00
2024-01-19 15:49:42 +01:00
### How to use (-b)
Just use this command, it will throw an error if incorrect.
Also, it will ask what you want to name the executable, and if it already exists.
```
RapidMenu -b [config]
```
2024-01-26 17:24:49 +01:00
2024-01-19 15:49:42 +01:00
## Configuration
It is required to have the [runner] section in the configuration.
Example:
```
[runner]
2024-07-28 12:28:59 +02:00
rname = "Dashboard:" #name if needed
rtheme = "-show-icons -theme ~/.config/rofi/themes/rounded-purple-dark.rasi" #theme if needed
rcommand = "rofi -dmenu -p" #dmenu, rofi, bemenu etc
2024-01-19 15:49:42 +01:00
```
An example of something to add to the configuration.
```
2024-07-28 12:28:59 +02:00
[Disk] #To set the name
names = "Disk" #To set the name in the runner
description = "You chose Disk." #Not required but can be set
command = "kitty -e /home/$USER/.config/RapidMenu/hdd.bash" #bash command
2024-01-19 15:49:42 +01:00
```
2024-01-26 17:24:49 +01:00
2024-01-19 15:49:42 +01:00
# Contributors
- DRAGONTOS
- maukkis