Repository files navigation

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!

Install from PyPI
python -m pip install konsave

konsave -h orkonsave --help

konsave -s <profile name> orkonsave --save <profile name>

konsave -s <profile name> -f orkonsave -s <profile name> --force

konsave -l orkonsave --list

konsave -r <profile name> orkonsave --remove <profile name>

konsave -a <profile name> orkonsave --apply <profile name>You may need to log out and log in to see all the changes.

konsave -e <profile name> orkonsave --export-profile <profile name>

konsave -e <profile name> -d <archive directory> -n <archive name>orkonsave --export-profile <profile name> --archive-directory <archive directory> --export-name <export name>

konsave -e <profile name> -f orkonsave --export-profile <profile name> --force*note: without --force, the export will be appended with the date and time to ensure unique naming and no data is overwritten

konsave -i <path to the file> orkonsave --import-profile <path to the file>

konsave -v orkonsave --version

konsave -w orkonsave --wipe

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.

The configuration file should be formatted in the following way:

---save:name:location:"path/to/parent/directory"entries:# These are files to be backed up.# They should be present in the specified location.            -file1            -file2export:# 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...

You can add more files/folders in the configuration file like this:

save:name:location:"path/to/parent/directory"entries:            -file1            -file2            -folder1            -folder2export:anotherName:location:"another/path/to/parent/directory"entries:                -file1                -file2                -folder1                -folder2

You can use a few placeholders in thelocation 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.

save:firefox:location:"$HOME/.mozilla/firefox/${ENDS_WITH='.default-release'}"entries:            -chrome

Please readCONTRIBUTION.md for info about contributing.

This project uses GNU General Public License 3.0