Working with multiple directories and execute commands without navigate to them with Workdir.
Documentation • Downloads • Issues
My tool Workdir is one of the oldest tools I use. I have not been navigating back and forth between directories for over ten years now. I press a button and open my directories directly. I can also start executing commands with one click. With another button I directly start the command line. And sometimes I directly start a command inside the directory. This makes working with directories much easier.
You can theoretically specify an unlimited number of directories. Up to six individual commands can be called. When the program starts, it checks whether the directory exists. If not, it will be colored red and no actions will be available.
Download the latest release into a destination folder of your choice and start the program. Via the configuration (menu Extras) you can specify your directories and store up to six commands.
Please note that in the current version you can only specify the directory itself as a placeholder. The examples for CMD and Windows Explorer should help you to implement your own calls. Once you click Save, the commands and directories are immediately available in the Directories tab.
For commands that you do not want to start by mistake, the program gives you, via the Confirmation option, a prompt to display. Here you will be shown a dialog before each execution, which you must confirm before the command is actually executed.
Please always specify the directories using the variable {directory}. This will be replaced and assembled accordingly when the commands are executed. Of course you can also specify executable files or shell scripts which will be called accordingly. This has not been necessary for ourselves so far.
You can also specify additional environment variables. They will be added to your default ones.
Workdir includes a tray icon. You can minimize the main window to the system tray and continue running commands from the tray menu.
Configuration is stored per user profile at ~/.workdir/config.json (on Windows this resolves to your user home, e.g. C:\\Users\\<user>\\.workdir\\config.json). It is no longer stored next to the binary.
I am asked from time to time if I would like to offer more than six commands. This request is mostly based on the need to handle different types of directories with different commands. Very gladly I give my answer in summary, so that it can help you from the beginning:
Workdir uses one configuration per user profile. Running the binary from different folders now uses the same configuration automatically.
If you run workdir the first time, the window can be really small. The size will be auto adjusted based on your directories. So please proceed by adding your directories.
If you want to contribute by fixing an issue, add a new function or just optimize something, a simple instruction how to start development.
Create and activate an environment by running the following command:
python -m venv .venv
On Windows:
.venv/Scripts/activate
On Linux/macOS:
source .venv/bin/activate
Install the required dependencies
pip install -r src/requirements.txt
To build and install the project using the new pyproject.toml:
pip install .To run the application:
python src/workdir.py
GPL 3.0 — see LICENSE file at the root of the repository for details.
RunIfExists uses Google Material Symbols within its code for UI icons.
Material Symbols are licensed under the Apache License 2.0 and are free for use in open source projects.
