📰 The Tribune Desk

The Tribune Desk is a powerful photo archiving and management application that helps you organize, timestamp, and upload your photos with ease. Built with Python and designed for photographers, journalists, and content creators who need efficient photo workflow management.

📥 Download & Run

Ready to use? Just download and run!

🚀 Quick Start (No Installation Required)

1. Download the latest release - Get the ready-to-use executable
2. Extract the ZIP file to your desired location
3. Run The Tribune Desk.exe - No Python installation needed!
4. Enter your credentials and start organizing photos

⚡ Key Features

• 🗄️ Automatic archiving with date-based folder structure (YYYY/MM-DD)
• 🕰️ Smart timestamping using original photo creation dates
• 🔒 Secure uploads to your personal server with API token authentication
• 📡 Live monitoring for automatic processing of new photos
• ✨ Duplicate detection to avoid clutter and save space
• 🖼️ Live preview of photos being processed

🛠️ Development Setup

Want to run from source code or contribute?

Prerequisites

• Python 3.7+
• PIL/Pillow for image processing
• Required dependencies (see requirements.txt)

Installation from Source

1. Clone the repository:

   git clone https://github.com/x3kim/TheTribuneDesk.git
   cd TheTribuneDesk

2. Install dependencies:

   pip install -r requirements.txt

3. Run the application:

   python TheTribuneDesk.py

📦 Building Executable

Create a standalone executable using PyInstaller:

cd build
pyinstaller TheTribuneDesk.spec

The executable will be generated in the build/dist/ directory.

🔧 Configuration

The application automatically creates a config.json file on first run. You can customize:

• API endpoint URL
• User authentication settings
• Default processing options

Note: The config.json file contains sensitive login data and is automatically generated by the app. See config.example.json for the expected structure.

🎨 Advanced

Project Structure

TheTribuneDesk/
├── TheTribuneDesk.py          # Main application
├── config.example.json        # Configuration template
├── assets/
│   ├── TheTribuneDesk.ico     # Application icon
│   └── TheTribuneDesk.png     # Source logo file
├── build/
│   └── TheTribuneDesk.spec    # PyInstaller build config
└── scripts/
    ├── convert_logo.py        # Logo conversion utility
    └── create_icon.py         # Icon generation utility

Helper Scripts

Regenerate application icon:

python scripts/create_icon.py

Convert logo to ICO format:

python scripts/convert_logo.py

🤝 Contributing

We welcome contributions! Please feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Improve documentation

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🌐 Support

For support and updates, visit: https://tht.x3kim.de

---

Made with ❤️ for photographers and content creators worldwide