Pixelebbe

Pixelebbe is like Pixelflut, but slower. Get your (hacker) friends together and fill the canvas with color(s)! Submit your pixel change requests via word-of-mouth, Eventphone DECT Call, a phone tree or fax. We also accept ChaosPost!

Features (not fully implemented)

• Multiple Events
• a very simple to use API to set pixels
• a beatuiful color palette
• Adjustable canvas sizes per event
• Pixel history tracking
• Rate limiting to prevent troll abuse

Current State of the codebase

The codebase currently implements:

• A predefined color palette with 32 colors (for now)
• Event management system for handling multiple canvases
• Admin interface for event configuration
• API endpoints for pixel manipulation
• User authentication system
• Pixel history visualization

Still in development:

• Sane Rate limiting implementation

Requirements

• Python 3.8+
• Flask
• Flask-SQLAlchemy
• Flask-Migrate
• Pillow (Python Imaging Library)

Prod Installation

Please refer to the file install.md for production install instructions.

Dev Installation

1. Clone the repository:

git clone https://github.com/yourusername/pixelebbe.git
cd pixelebbe

2. Create a virtual environment and activate it:

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

3. Install dependencies:

pip install -r requirements.txt

4. Copy the example configuration file and modify it:

cp config.py.example config.py
nano config.py

5. Initialize the database:

python setup.py

6. Start the development server:

FLASK_DEBUG=1 flask run

The application will be available at http://localhost:5000

Database Migrations

When you make changes to the database models in database.py, you need to create and apply migrations:

1. Create a new migration:

flask db migrate -m "Description of your changes"

2. Review the generated migration file in the migrations/versions directory

3. Apply the migration:

flask db upgrade