Metadata-Version: 2.1
Name: Konsave
Version: 2.0.1
Summary: A program that lets you save your Plasma configuration in an instant!
Home-page: https://www.github.com/prayag2/konsave/
Author: Prayag Jain
Author-email: prayagjain2@gmail.com
License: UNKNOWN
Description: <h1 align=center> Konsave (Save Linux Customization) </h1>
        <p align=center>A CLI program that will let you save and apply your Linux customizations with just one command! It officially supports KDE Plasma but it can be used on all other desktop environments too!</p>
        
        ---
        
        <p align="center">
        <img src="https://user-images.githubusercontent.com/39525869/109611033-a6732c80-7b53-11eb-9ece-ffd9cef49047.gif" />
        </p>
        
        ---
        
        ## 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 <profile name>` or `konsave --save <profile name>`
        ### Overwrite an already saved profile
        `konsave -s <profile name> -f` or `konsave -s <profile name> --force `
        ### List all profiles
        `konsave -l` or `konsave --list`
        ### Remove a profile
        `konsave -r <profile id>` or `konsave --remove <profile id>`
        ### Apply a profile
        `konsave -a <profile id>` or `konsave --apply <profile id>`
        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 <profile id>` or `konsave --export-profile <profile id>`
        ### Import a ".knsv" file
        `konsave -i <path to the file>` or `konsave --import-profile <path to the file>`
        ### Show current version
        `konsave -v` or `konsave --version`  
        ### Wipe all profiles
        `konsave -w` or `konsave --wipe`
        
        <br><hr><br>
        
        
        ## 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/config.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:
        ```
        ---
        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:
        ```
        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 variables and functions
        You can use a few variables and functions in the `location` of each entry in the configuration file. These are:  
        `$HOME`: points to the home directory  
        `$CONFIG_DIR`: points to `~/.config`  
        `$KONSAVE_DIR`: points to `~/.config/konsave`  
        `$PROFILES_DIR`: points to `~/.config/konsave/profiles`  
        `${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 in `~/.mozilla/firefox`.  
        `${BEGINS_WITH="text"}`: for folders with different names on different computers whose names start with the same thing.  
        Here's an example of how you can use these variables:
        ```
        save:
            firefox:
                location: "$HOME/.mozilla/firefox/${ENDS_WITH='.default-release'}"
                entries:
                    - chrome
        ```
        
        <br><hr><br>
        
        ## 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
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
