Skip to content

KDE Migrant allows you to migrate your existing KDE/Plasma/apps configuration to a new computer. Good when changing computers or cloning one user configuration for other users.

License

Notifications You must be signed in to change notification settings

nekromoff/kde-migrant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 

Repository files navigation

KDE Migrant 🧳

KDE Migrant allows you to migrate your existing KDE configuration to a new computer. Good when changing computers or cloning one user configuration for other users.

A single file browser and command-line script that allows you to backup your full or partial KDE configuration including apps, dotfiles and any customizations. It works for KDE Plasma widgets as well.

It creates a ZIP file that you can transfer to a different computer to unzip it.

1. CLI: Gather user home directory structure

Run from command line:

php migrant.php scan

or run scan as a different user:

sudo -u [user] php migrant.php scan

2. Browser: Configure which settings to back up

  1. Open migrant.php in your browser (e.g.: http://localhost/kde-migrant/migrant.php)
  2. Select configuration folders and files to back up (or select whole categories such as KDE, Plasma, Flatpaks, Snaps)
  3. Confirm to create backup configuration

Note: Files or folders larger than 100 KB will have filesize information on red background shown next to them.

3. CLI: Run backup process

Dry run to simulate backup based on existing configuration:

php migrant.php dryrun

Run backup based on existing configuration:

php migrant.php backup

or run backup as a different user:

sudo -u [user] php migrant.php backup

migrant.zip file will be created.

4. Transfer migrant.zip to target computer

And extract it there.

Please note that KDE Migrant 🧳 creates a ZIP file with full paths (e.g. /home/user/*). When cloning single user's config files for multiple users, extract and change paths as needed.

Screenshots

CLI: Running scan to gather home directory structure (for correct access permissions):

0

Browser: Select folders and files to back up / migrate:

1

2

Browser: Configuration created

3

CLI: Usage and help

help

FAQ

Is it possible to add different folders to back up (e.g. not located in user home directory)?

Yes, edit migrant.php and edit these constants: FOLDERS_SCAN and FILES_SCAN. Add paths to scan. Note that user has to have read access to them in order to back them up.

How can I change matching pattern for one-click group such as KDE checkbox on top?

Edit KDE_MATCH constant and add your pattern separated by | pipe character. E.g. add |user to include all folders+files containing user in their name.

Please ⭐ star 🌟 this repo, if you like it and use it.

About

KDE Migrant allows you to migrate your existing KDE/Plasma/apps configuration to a new computer. Good when changing computers or cloning one user configuration for other users.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Languages