https://github.com/skullface/sceneland

🎸 automatically aggregates Cleveland-area concerts in one place
https://github.com/skullface/sceneland

beautifulsoup cleveland concerts ohio scraping

Last synced: about 1 month ago
JSON representation

🎸 automatically aggregates Cleveland-area concerts in one place

• Host: GitHub
• URL: https://github.com/skullface/sceneland
• Owner: skullface
• Created: 2023-08-07T01:47:28.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-13T09:05:53.000Z (about 1 month ago)
• Last Synced: 2024-12-13T09:07:09.265Z (about 1 month ago)
• Topics: beautifulsoup, cleveland, concerts, ohio, scraping
• Language: JavaScript
• Homepage: https://216.show/
• Size: 15.7 MB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 🎸 [216.show](https://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](https://github.com/skullface/sceneland/tree/main/script/venues)

- Export that data [per venue as JSON](https://github.com/skullface/sceneland/tree/main/src/data/venues)

- [Merge](https://github.com/skullface/sceneland/blob/main/script/merge.py) JSON files together as [a `.js` array of objects](https://github.com/skullface/sceneland/blob/main/src/data/allShows.js)

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

- Use the `.js` data file to [display events](https://github.com/skullface/sceneland/blob/main/src/components/show-card.tsx) in chronological order

- [Group events by week](https://github.com/skullface/sceneland/blob/main/src/pages/index.tsx#L92-L139) for improved readability/scannability

- [Filter](https://github.com/skullface/sceneland/blob/main/src/pages/index.tsx#L51-L90) events by venue, [selectable by user](https://github.com/skullface/sceneland/blob/main/src/components/venue-filter.tsx) (via [Radix](https://www.radix-ui.com/primitives/docs/components/dropdown-menu#checkboxitem))

- Serve the page [statically](https://github.com/skullface/sceneland/blob/main/.github/workflows/build-and-deploy.yml) with [GitHub Pages](https://github.com/skullface/sceneland/tree/gh-pages) when data file is updated

- [Generate](https://github.com/skullface/sceneland/blob/main/src/utils/generate-feed.ts) an [RSS feed](https://216.show/feed.xml) with all shows as feed items

### Update daily

- At 5:00am ET, [refresh data](https://github.com/skullface/sceneland/blob/main/.github/workflows/fetch-data.yml) by re-fetching, re-merging, and re-deploying

## Fork this repo for your own city

### Local requirements

- Install [Python](https://www.python.org/downloads/)

- 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](https://nodejs.org/en)

- Install Node dependencies with `npm i`

### Data

- Create [Python scripts](https://github.com/skullface/sceneland/tree/main/script/venues) for your own venues’ websites using [BeautifulSoup](https://beautiful-soup-4.readthedocs.io/en/latest/)

- [Re-map related venues](https://github.com/skullface/sceneland/blob/main/src/pages/index.tsx#L51-L57) if necessary

- Update your [timezone](https://github.com/search?q=repo%3Askullface%2Fsceneland%20New_York&type=code) as necessary

### Repo settings

- **Actions**: Give Actions “Read and write permissions”

- **Pages**: Enable GitHub Pages to deploy from `gh-pages` branch