Skip to content

dale-tomson/declutter

Repository files navigation

Declutter Logo

Declutter

Organize your files into Year/Month folders based on their timestamps

Release License Go Report Card Website

WebsiteFeaturesScreenshotsInstallationBuild


Features

  • 📁 Auto Organization — Creates year folders (e.g., 2024) and month subfolders (e.g., 01-January)
  • 🕐 Timestamp-based — Uses file modification dates to determine the correct folder
  • 🖥️ Cross-platform — Works on Windows, macOS, and Linux
  • Fast & Efficient — Built with Go for blazing fast file operations
  • 🎨 Modern UI — Clean, intuitive interface built with Fyne
  • 🔒 Safe — Skips files that already exist at destination, no overwrites

Screenshots

Launch App
Launch the application

Folder Selected
Select a folder to organize

Organization Complete
Files organized into Year/Month folders

How It Works

  1. Select a folder containing files you want to organize
  2. Click "Organize Files" to start
  3. Done! Files are moved to Year/Month folders

Before & After

Downloads/                          Downloads/
├── vacation.jpg (Mar 2024)         ├── 2023/
├── birthday.jpg (Mar 2024)         │   └── 12-December/
├── christmas.jpg (Dec 2023)   →    │       └── christmas.jpg
└── new-year.jpg (Jan 2024)         └── 2024/
                                        ├── 01-January/
                                        │   └── new-year.jpg
                                        └── 03-March/
                                            ├── vacation.jpg
                                            └── birthday.jpg

Installation

Download

Get the latest release for your platform from the Releases page or the website.

Platform Download
Windows declutter-windows.exe
macOS declutter-darwin
Linux declutter-linux

Important

macOS Users: When opening the app for the first time, you may see a "Malware" warning. This is because the app is not notarized. See our Gatekeeper guide for a safe, one-time workaround (Right-click -> Open).

Note

Windows Users: Windows Defender may show a false positive warning. This is a common issue with Go applications and is completely safe. See our Windows Defender troubleshooting guide for solutions.

Building from Source

Prerequisites

  • Go 1.21+
  • Platform dependencies:

Linux:

sudo apt-get install libgl1-mesa-dev xorg-dev libxrandr-dev pkg-config

macOS: Xcode command line tools

Windows: MinGW or similar C compiler

Build

git clone https://github.com/dale-tomson/declutter.git
cd declutter
go mod tidy
go build -o declutter .

Run

./declutter

Usage

  1. Launch Declutter
  2. Click Select Folder and choose a folder with files to organize
  3. Review the file count in the activity log
  4. Click Organize Files and confirm
  5. Watch the progress as files are moved to their Year/Month folders

Testing

go test ./...

Project Structure

declutter/
├── main.go                 # Application entry point
├── internal/
│   ├── icon/              # Embedded app icon
│   ├── organizer/         # File organization logic
│   ├── theme/             # Custom Fyne theme
│   ├── ui/                # User interface
│   └── version/           # Version information
├── docs/                  # GitHub Pages website
└── scripts/               # Helper scripts (version bumping)

Cross-Compilation

go install fyne.io/tools/cmd/fyne@latest

fyne package -name "Declutter"              # Current platform
fyne package -os windows -name "Declutter"  # Windows
fyne package -os darwin -name "Declutter"   # macOS
fyne package -os linux -name "Declutter"    # Linux

License

MIT License — feel free to use this project for personal or commercial purposes.

Changelog

See CHANGELOG.md for a list of all changes, or browse individual release notes in the docs/changelogs folder.

Latest: v1.1.3 - macOS packaging improvements (.app bundle), documentation updates, and project restructuring.

Contributing

Contributions are welcome! Feel free to:

  • 🐛 Report bugs by opening an issue
  • 💡 Suggest features or improvements
  • 🔧 Submit pull requests

Made with ❤️ using Go and Fyne

About

A cross-platform standalone application built with [Fyne](https://fyne.io/) (Go) that organizes files into Year/Month folders based on their timestamps.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors