Skip to content

README.md

Latest commit

 

History

History
150 lines (116 loc) · 3.86 KB

README.md

File metadata and controls

150 lines (116 loc) · 3.86 KB
Raw

FolderZipperVersioning

A Python Tkinter GUI application that zips folders with automatic version numbering.

Version Python License Platform

Features

  • 📁 Easy Folder Selection via GUI
  • 🔢 Auto Version Numbering (001, 002, 003...)
  • ✏️ Custom Version Input
  • 🕐 Timestamp in filenames
  • 🌙 Dark Mode Support (Windows)
  • 📂 Directory Navigation
  • 🐧 Linux Package Support (deb, pkg.tar.zst, rpm)

Screenshots

App Icon

Installation

Windows

Download Executable:

# Download FolderZipperVersioning.exe from builds/ folder
# Double-click to run

Or run from source:

pip install -r requirements.txt
python app-files/zipper.py

Linux

Ubuntu/Debian:

sudo apt install ./builds/folder-zipper-versioning_1.2_all.deb
folder-zipper-versioning

Arch Linux:

sudo pacman -U builds/folder-zipper-versioning-1.2-1-any.pkg.tar.zst
folder-zipper-versioning

Fedora/RHEL:

sudo dnf install builds/folder-zipper-versioning-1.2-1.noarch.rpm
folder-zipper-versioning

Or run from source:

sudo apt install python3-tk  # Debian/Ubuntu
python3 app-files/zipper.py

📖 See docs/INSTALL.md for detailed installation instructions.

Usage

  1. Launch the application
  2. Navigate to the folder you want to zip
  3. (Optional) Enter a custom version number
  4. Click "Zip Selected Folder"
  5. The zip file is created in the parent directory with format:
    • Auto-version: foldername_001_2026-03-20_16-30.zip
    • Custom version: 1.2-foldername_2026-03-20_16-30.zip

📖 See docs/USAGE.md for detailed usage guide.

Building

Windows

python build.py
# Output: builds/FolderZipperVersioning.exe

Linux

Build executable:

python3 build.py --executable
# Output: builds/FolderZipperVersioning

Build all packages:

python3 build.py --all
# Output: builds/*.deb, builds/*.pkg.tar.zst, builds/*.rpm

Build specific package:

python3 build.py --deb    # Debian package
python3 build.py --arch   # Arch package
python3 build.py --rpm    # RPM package

Project Structure

zip-folder-automation/
├── app-files/
│   ├── zipper.py          # Main application
│   ├── test_zipper.py     # Unit tests
│   └── icon.png           # Application icon
├── builds/
│   ├── FolderZipperVersioning.exe  # Windows executable
│   ├── FolderZipperVersioning      # Linux executable
│   ├── *.deb                       # Debian package
│   ├── *.pkg.tar.zst               # Arch package
│   └── *.rpm                       # RPM package
├── debian/                 # Debian packaging files
├── arch-linux/             # Arch packaging files
├── rpm/                    # RPM packaging files
├── docs/
│   ├── INSTALL.md          # Installation guide
│   ├── USAGE.md            # Usage guide
│   ├── FEATURES.md         # Feature documentation
│   └── CHANGELOG.md        # Version history
├── internals/              # Secrets and sensitive files (not in git)
├── build.py                # Build script
├── requirements.txt        # Python dependencies
└── README.md               # This file

License

MIT License - see LICENSE file for details.

Contributing

See CONTRIBUTING.md for contribution guidelines.

Support