🦝 Raccoon Timekeeper

A self-hosted time tracking application with a sleek grayscale design.

Features

• ⏱️ Flexible Time Entry - Log time in multiple formats (1:30, 1.5, 90m, 1h 30m)
• 📅 Weekly Summaries - View time grouped by task and day (Monday-Sunday weeks)
• 🖨️ Printable Timesheets - Generate clean printable weekly reports
• 📋 Task Management - Create, edit, and organize your tasks
• 📊 Data Export - Export your data as JSON or CSV
• 🎨 Raccoon Theme - Sleek grayscale design

Quick Start

Using Docker (Recommended)

# Clone the repository
git clone https://gitea.hideawaygaming.com.au/jessikitty/Raccoon-TimeKeeper.git
cd Raccoon-TimeKeeper

# Start with Docker Compose
docker-compose up -d

# Access at http://localhost:5000

Manual Installation

# Clone the repository
git clone https://gitea.hideawaygaming.com.au/jessikitty/Raccoon-TimeKeeper.git
cd Raccoon-TimeKeeper

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Copy environment file
cp .env.example .env

# Run the application
python app.py

# Access at http://localhost:5000

Configuration

Create a .env file based on .env.example:

SECRET_KEY=your-super-secret-key-change-me
DATABASE_URL=sqlite:///data/timekeeper.db
DEBUG=false

Time Entry Formats

The time input field accepts multiple formats:

Format	Example	Result
Hours:Minutes	1:30	1h 30m
Decimal Hours	1.5	1h 30m
Minutes	90m	1h 30m
Hours	2h	2h 0m
Combined	1h 30m	1h 30m

API Endpoints

Method	Endpoint	Description
GET	/api/tasks	Get all tasks
POST	/api/tasks	Create a task
PUT	/api/tasks/<id>	Update a task
DELETE	/api/tasks/<id>	Delete a task
GET	/api/entries	Get all time entries
POST	/api/entries	Create a time entry
PUT	/api/entries/<id>	Update a time entry
DELETE	/api/entries/<id>	Delete a time entry
GET	/api/weekly-summary	Get weekly summary

Project Structure

raccoon-timekeeper/
├── app.py              # Main Flask application
├── requirements.txt    # Python dependencies
├── Dockerfile          # Docker build file
├── docker-compose.yml  # Docker Compose config
├── .env.example        # Example environment file
├── templates/          # HTML templates
│   ├── base.html
│   ├── index.html
│   └── settings.html
└── static/
    ├── css/
    │   └── style.css   # Raccoon grayscale theme
    └── js/
        ├── app.js      # Shared utilities
        ├── index.js    # Index page logic
        └── settings.js # Settings page logic

Development

# Run in debug mode
DEBUG=true python app.py

License

MIT License - feel free to use and modify!

---

Made with 🦝 by Raccoon Timekeeper