3 releases

0.1.3 Apr 26, 2024
0.1.1 Apr 16, 2024
0.1.0 Apr 9, 2024

#210 in Command line utilities

Download history 133/week @ 2024-04-05 134/week @ 2024-04-12 12/week @ 2024-04-19 135/week @ 2024-04-26 6/week @ 2024-05-03

295 downloads per month

Custom license

575 lines


Organise your computer by replacing user folders with symlinks to project folders.

Wechsel is a simple tool that helps you by creating individual Download, Desktop, ... folders for each project. It replaces the original folders with symlinks to the folders of the current active project. Like this the random files you download, will be placed in the Download folder they belong to.

Additionaly each project can have init scripts that allow you to do things like automaticly sourcing python enviroments in your python projects.

How it works

Wechsel stores all the information about your project in a config fille called wechsel_projects.json. This file contains a tree structure of all your project. Every project is an entry in that tree that holds information about the project like the name of the project, the path of the project folder of the list of its children.

When switching project this file is read to find out which folders are going to be symlinked and what the symlink targets should be.

If a project dosnt't have a folder that a parent project does have, the folder of the parent project is used. E.g. you project uni does not have a Music folder but your root project does, then when swiching to the uni project the Music folder of the root project will be symlinked.


There is an acompanying gnome extension that integrates Wechsel into the gnome shell.


The simplest way to install Wechsel is with cargo:


cargo install wechsel

Github Release

Download the latest release from the release page. Move the binary to a folder in your PATH and make it executable.


Wechsel needs to go through an initial setup to create the necessary folders and files. To do this run wechsel init. This will guide you through the setup process.

The main thing this will do is creating a folder in your home directory, lets say is called "projects" that will be the place all projects are put. And a root project, lets call it "default" that will be the root of the project tree.

Then it will move the original folders (It will ask you which ones) from your home folder to the root project. And create symlinks in their place.


~153K SLoC