Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Keep or Sweep

Randomly declutter your computer!


This is the desktop app (v0.1.0) for ⊞Windows, 🍏macOS & 🐧Linux.

There’s also a ☁️Nextcloud app, and more info at πŸ”€


Contributions are always welcome! 😍 Check out the list of issues and see what you like to contribute. Keep or Sweep is written in 🐍Python so if you know about that – come on board!

Development setup

  1. Install the dependencies: We need Pillow (Python library for image handling) and Send2Trash (to move files to trash cross-platform instead of permanently removing them). Type these commands in a terminal window:
sudo easy_install pip
pip3 install -r requirements.txt
  1. Make executable by right-click β†’ Properties β†’ Allow executing file as program. (Or in the terminal with chmod +x
  2. Then place in any folder and click it! πŸŽ‰ (Or in the terminal run python3

Building an executable app

  1. Install PyInstaller via terminal:
pip3 install pyinstaller
  1. Then use this command to build the application for your operating system (use icon.icns instead of icon.ico when building on macOS):
pyinstaller --name="Keep or Sweep" --onefile --noconsole --icon="images/icon.ico" --clean
  1. The executable file will be in the dist subfolder.

In case the icon was changed, we need to generate those again. Windows .ico uses the 256px icon and can be saved using GIMP, macOS .icns uses icons ranging from 16px to 1024px and can be generated using png2icns.