Dothub
A comfortable HUB for your dotfiles :)
Very early alpha, be aware!
Usage
At your $HOME, .dothub is going to be created.
Here you can create a directory (DotFolder) named, for example polybar.
Inside polybar, you have to create a .dothub file for configuration (in TOML), the only required option is destination which dictates where is the location of your dot file folder.
All the options are:
| option | type | description |
|---|---|---|
| start | String | Command to start the program/what you are configuring |
| kill | String | Command to kill that program |
| reload | String | Command to reaload the program. By default uses kill + start commands |
| destination | String | REQUIRED Destination of the dotfile folder |
| reload_on_set | Bool | If the program should restart after setting a new Dot. Default is true |
| find_and_replace | Bool | Finds the same named files/directories inside destination and replaces only those. Useful for changing only some files and directories inside a bigger folder, eg. ~/home or ~/.config. Default is false |
In your DotFolder, you can create more folders (Dots) which will be symlinked to your destination on dothub set.
You can have a .dothub file inside a Dot, which will be prioritized over your DotFolder's configuration.
Avaiable commands:
| command | description |
|---|---|
| set | Applies a dot. |
| watch | Watches a Dot and reloads on any change. (basically brings "hot-reload" to any program) |
| list | Lists all Dots |
| start | Runs the Dots 'start' command. |
| kill | Runs the Dots 'kill' command. |
| reload | Runs the Dots 'reload' command. If 'reload' isn't specified, it will try to use 'kill' and 'start' as an alternative. |
| run | Runs a program forked, with a different PID. (doesn't halt the terminal, you can use your WM/Compositor solutions) |
| edit | Launches $EDITOR with specified Dot. |
| profile | *with profile commands, list below |
Profile commands:
| command | description |
|---|---|
| set | Applies a profile |
| list | Lists all profiles |
Profiles
With the generation of .dothub in your $HOME, a folder called profiles will also be created, this isn't counted as a DotFolder.
In your profiles, you can define a profile as a file in .toml with two optional "fields".
| option | type | description |
|---|---|---|
| start | array | Array of commands that should be executed on dothub profile set |
| dots | map | A hashmap of DotFolder = "Dot", see example |
Example
In your .dothub:
profiles/
ocean.toml
red.toml
waybar/
.dothub
nord/
one_dark/
wofi/
.dothub
general/
minimalist/
In profiles/ocean.toml:
start = [
"notify-send 'Profile set!'",
"notify-send 'You are now using profile ~ocean~ :)'"
]
[dots]
waybar = "nord"
wofi = "minimalist"
In waybar/.dothub:
start = 'dothub run waybar'
kill = 'pkill waybar'
destination = '~/.config/waybar'
To apply a DotProfile:
dothub profile set ocean
To apply a Dot:
dothub set waybar/neon