skullface / sceneland

🎸 automatically aggregates Cleveland-area concerts in one place

🎸 216.show

Aggregates concerts from local Cleveland venues in one website.

How it works

Get show data (🐍 Python)

• Extract and normalize data from local venues’ websites with Python
• Export that data per venue as JSON
• Merge JSON files together as a .js array of objects

Present show data (⚛️ React via Next.js)

• Use the .js data file to display events in chronological order
• Group events by week for improved readability/scannability
• Filter events by venue, selectable by user (via Radix)
• Serve the page statically with GitHub Pages when data file is updated
• Generate an RSS feed with all shows as feed items

Update daily

• At 5:00am ET, refresh data by re-fetching, re-merging, and re-deploying

Fork this repo for your own city

Local requirements

• Install Python
• Install Python dependencies with pip install -r requirements.txt
  • The dependencies you need will change based on your own Python scripts, but consider “requests”, “BeautifulSoup”, and “json” as required :)
• Install Node.js
• Install Node dependencies with npm i

Data

• Create Python scripts for your own venues’ websites using BeautifulSoup
• Re-map related venues if necessary
• Update your timezone as necessary

Repo settings

• Actions: Give Actions “Read and write permissions”
• Pages: Enable GitHub Pages to deploy from gh-pages branch