Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Prayag2/konsave
A command line program written in Python to let you backup your dotfiles and switch to other ones in an instant. Works out-of-the box on KDE Plasma!
https://github.com/Prayag2/konsave
backup customization desktop-environment hacktoberfest kde kde-plasma kde-plasma-customizatios konsave linux plasma plasma-5
Last synced: about 2 months ago
JSON representation
A command line program written in Python to let you backup your dotfiles and switch to other ones in an instant. Works out-of-the box on KDE Plasma!
- Host: GitHub
- URL: https://github.com/Prayag2/konsave
- Owner: Prayag2
- License: gpl-3.0
- Created: 2021-02-27T15:09:33.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-18T15:44:37.000Z (4 months ago)
- Last Synced: 2024-07-18T06:13:17.250Z (2 months ago)
- Topics: backup, customization, desktop-environment, hacktoberfest, kde, kde-plasma, kde-plasma-customizatios, konsave, linux, plasma, plasma-5
- Language: Python
- Homepage:
- Size: 150 KB
- Stars: 895
- Watchers: 12
- Forks: 35
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Konsave (Save Linux Customization)
A CLI program that will let you save and apply your Linux customizations with just one command! Konsave also lets you share your dot files to your friends in an instant! It officially supports KDE Plasma but it can be used on all other desktop environments too!
---
---
## Installation
Install from PyPI
`python -m pip install konsave`
## Usage
### Get Help
`konsave -h` or `konsave --help`
### Save current configuration as a profile
`konsave -s ` or `konsave --save `
### Overwrite an already saved profile
`konsave -s -f` or `konsave -s --force `
### List all profiles
`konsave -l` or `konsave --list`
### Remove a profile
`konsave -r ` or `konsave --remove `
### Apply a profile
`konsave -a ` or `konsave --apply `
You may need to log out and log in to see all the changes.
### Export a profile as a ".knsv" file to share it with your friends!
`konsave -e ` or `konsave --export-profile `
### Export a profile, setting the output dir and archive name
`konsave -e -d -n `
or
`konsave --export-profile --archive-directory --export-name `
### Export a profile, overwrite files if they already exist
`konsave -e -f` or `konsave --export-profile --force`
*note: without --force, the export will be appended with the date and time to ensure unique naming and no data is overwritten
### Import a ".knsv" file
`konsave -i ` or `konsave --import-profile `
### Show current version
`konsave -v` or `konsave --version`
### Wipe all profiles
`konsave -w` or `konsave --wipe`
---
## Editing the configuration file
You can make changes to Konsave's configuration file according to your needs. The configuration file is located in `~/.config/konsave/conf.yaml`.
When using Konsave for the first time, you'll be prompted to enter your desktop environment.
For KDE Plasma users, the configuration file will be pre-configured.
### Format
The configuration file should be formatted in the following way:
```yaml
---
save:
name:
location: "path/to/parent/directory"
entries:
# These are files to be backed up.
# They should be present in the specified location.
- file1
- file2
export:
# This includes files which will be exported with your profile.
# They will not be saved but only be exported and imported.
# These may include files like complete icon packs and themes..
name:
location: "path/to/parent/directory"
entries:
- file1
- file2
...
```
### Adding more files/folders to backup
You can add more files/folders in the configuration file like this:
```yaml
save:
name:
location: "path/to/parent/directory"
entries:
- file1
- file2
- folder1
- folder2
export:
anotherName:
location: "another/path/to/parent/directory"
entries:
- file1
- file2
- folder1
- folder2
```
### Using placeholders
You can use a few placeholders in the `location` of each entry in the configuration file. These are:
`$HOME`: the home directory
`$CONFIG_DIR`: refers to "$HOME/.config/"
`$SHARE_DIR`: refers to "$HOME/.local/share"
`$BIN_DIR`: refers to "$HOME/.local/bin"
`${ENDS_WITH="text"}`: for folders with different names on different computers whose names end with the same thing.
The best example for this is the ".default-release" folder of firefox.
`${BEGINS_WITH="text"}`: for folders with different names on different computers whose names start with the same thing.
```yaml
save:
firefox:
location: "$HOME/.mozilla/firefox/${ENDS_WITH='.default-release'}"
entries:
- chrome
```
---
## Contributing
Please read [CONTRIBUTION.md](https://github.com/Prayag2/konsave/blob/master/CONTRIBUTION.md) for info about contributing.
## License
This project uses GNU General Public License 3.0