Showtime

Get notified when artists you actually listen to are playing in the Bay Area.

No more missing shows because you didn't know. No more sifting through garbage recommendations. Just your music, your concerts.

How it works

1. Syncs with Tautulli - Pulls your actual listening history from Plex
2. Searches Bandsintown - Finds upcoming Bay Area concerts for those artists
3. Notifies you - Sends email when shows are coming up
4. Respects your opt-outs - Never hear about the Rolling Stones again (if that's your thing)

Installation

# Clone and install
cd showtime
pip install -e .

# Copy and configure environment
cp .env.example .env
# Edit .env with your settings

Configuration

Edit .env with your settings:

# Tautulli (required)
TAUTULLI_URL=http://localhost:8181
TAUTULLI_API_KEY=your_api_key_here

# Email notifications
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your_email@gmail.com
SMTP_PASSWORD=your_app_password  # Use an app password, not your real password
NOTIFICATION_EMAIL=your_email@gmail.com

# Behavior
MIN_PLAY_COUNT=3  # Only track artists you've played 3+ times

Getting your Tautulli API key

1. Open Tautulli web interface
2. Go to Settings > Web Interface
3. Copy the API Key

Gmail App Password

If using Gmail, you need an App Password:

1. Go to https://myaccount.google.com/apppasswords
2. Create a new app password for "Mail"
3. Use that password in SMTP_PASSWORD

Usage

# First time setup
showtime init

# Sync your listening history
showtime sync

# Find and display upcoming shows
showtime shows
showtime shows --days 60
showtime shows --refresh  # Search for new concerts first

# Look up a specific artist
showtime artist "Radiohead"

# Opt out artists you don't want to hear about
showtime optout add "The Rolling Stones" --reason "old losers whose time has passed"
showtime optout list
showtime optout remove "The Rolling Stones"

# Send email notification for new concerts
showtime notify

# Run continuously (daemon mode)
showtime watch --interval 6  # Check every 6 hours

# See your stats
showtime stats

Commands

Command	Description
showtime init	Initialize database and test connections
showtime sync	Pull listening history from Tautulli
showtime shows	Display upcoming concerts
showtime artist NAME	Look up a specific artist
showtime optout add NAME	Block an artist from notifications
showtime optout remove NAME	Unblock an artist
showtime optout list	List all blocked artists
showtime notify	Send email for new concerts
showtime watch	Run daemon, check periodically
showtime stats	Show library statistics

Data Storage

Everything is stored locally in ~/.showtime/showtime.db (SQLite).

Your data stays on your machine.

Why this exists

Every "concert notification" app sucks because:

• They don't know what you actually listen to
• They spam you with garbage
• They require accounts and share your data
• They're bloated with features you don't need

Showtime is different:

• Uses YOUR real listening data from Plex/Tautulli
• Simple opt-out for artists you're done with
• Runs locally, no accounts, no tracking
• Does one thing well