TheLovinator/ttvdrops
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Get notified when a new drop is available on Twitch or Kick https://ttvdrops.lovinator.space/
15 commits 1 branch 0 tags 1.4 MiB
  • Python 82.5%
  • HTML 17.1%
  • XSLT 0.4%
Find a file
Joakim Hellsén e4b8c91b73 Add management command to clean PlaybackAccessToken response files
2025-07-10 04:01:09 +02:00
.vscode Add initial configuration and structure for the Twitch app, including models, views, and admin registration 2025-07-08 19:05:36 +02:00
config feat: Add Twitch Drops Tracker application with campaign management 2025-07-09 22:46:23 +02:00
core Add initial configuration and structure for the Twitch app, including models, views, and admin registration 2025-07-08 19:05:36 +02:00
templates Add game list and detail views with templates for Twitch Drops Tracker 2025-07-10 03:09:27 +02:00
twitch Add management command to clean PlaybackAccessToken response files 2025-07-10 04:01:09 +02:00
.env.example Add environment configuration and email settings 2025-07-08 04:33:05 +02:00
.gitignore Add responses directory to .gitignore for TTVDrops 2025-07-08 05:45:43 +02:00
.python-version Add initial project configuration files and Python version 2025-07-08 01:29:27 +02:00
conftest.py Add environment configuration and email settings 2025-07-08 04:33:05 +02:00
LICENSE Initial commit 2025-07-08 01:21:59 +02:00
manage.py Refactor Django project files to improve type hinting and code clarity 2025-07-08 01:47:39 +02:00
pyproject.toml feat: Add Twitch Drops Tracker application with campaign management 2025-07-09 22:46:23 +02:00
README.md feat: Add Twitch Drops Tracker application with campaign management 2025-07-09 22:46:23 +02:00
uv.lock Add environment configuration and email settings 2025-07-08 04:33:05 +02:00

README.md

ttvdrops

Get notified when a new drop is available on Twitch

Features

  • Import and track Twitch drop campaigns
  • View campaign details including start/end dates and rewards
  • Filter campaigns by game and status
  • Dashboard with active campaigns and quick stats
  • Admin interface for managing campaigns and drops

Installation

  1. Clone the repository
git clone https://github.com/TheLovinator1/ttvdrops.git
cd ttvdrops
  1. Install dependencies
uv sync

  1. Set up environment variables by modifying the .env file

  2. Apply migrations

uv run python manage.py migrate
  1. Create a superuser
uv run python manage.py createsuperuser

Usage

Running the server

uv run python manage.py runserver

Access the application at http://127.0.0.1:8000/

Importing drop campaigns

uv run python manage.py import_drop_campaign path/to/your/json/file.json

Development

uv run python manage.py createsuperuser
uv run python manage.py makemigrations
uv run python manage.py migrate
uv run python manage.py collectstatic
uv run python manage.py runserver
uv run pytest

Project Structure

  • twitch/ - Main app for Twitch drop campaigns

    • models.py - Database models for campaigns, drops, and benefits
    • views.py - Views for displaying campaign data
    • admin.py - Admin interface configuration
    • management/commands/ - Custom management commands
      • import_drop_campaign.py - Command for importing JSON data

  • templates/ - HTML templates

    • twitch/ - App-specific templates
      • dashboard.html - Dashboard view
      • campaign_list.html - List of all campaigns
      • campaign_detail.html - Detailed view of a campaign

License

See the LICENSE file for details.