https://github.com/maxpleaner/bandcamp_labels
A website which lists record labels on bandcamp
https://github.com/maxpleaner/bandcamp_labels
Last synced: 6 months ago
JSON representation
A website which lists record labels on bandcamp
- Host: GitHub
- URL: https://github.com/maxpleaner/bandcamp_labels
- Owner: MaxPleaner
- Created: 2017-03-03T17:29:44.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-05T19:09:24.000Z (over 9 years ago)
- Last Synced: 2025-01-29T12:15:24.930Z (over 1 year ago)
- Language: HTML
- Homepage: http://maxpleaner.github.io/bandcamp_labels
- Size: 1.28 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### What it is
A website indexing the labels on bandcamp.
### How it's built
To get the search results from bandcamp, I'm using the `bandcamp-scraper` npm tool
with coffeescript.
This coffeescript is called by ruby in order to get a listing of labels.
Markdown pages are then build for each label, which plug into my
[static](http://github.com/maxpleaner/static) website generator.
The result of this is a static website that can be deployed to github pages or
wherever.
### How to use
1. The first step is to clone the repo.
2. Run `npm install` and `bundle` to get the dependencies
3. Run `bundle exec rake get_labels[metal]` to create markdown pages for the metal
labels. You can substitute `metal` for your own query, like `electroacoustic` or
`plunderphonics` (I don't know if there are actually any results for these).
4. Run `ruby gen.rb` to compile the markdown pages into a static website.
5. Either open `dist/index.html` from your browser, or run `ruby webrick.rb` then
visit `http://localhost:8000` in your browser.
6. Create a new github repo and point your origin to it. Then run the `push_dist_to_gh_pages`
script and voila, you have a public website.
### Other notes
This repo is already seeded with the contents of the site as visible
[here](http://maxpleaner.github.io/bandcamp_labels). So there are 1k+ markdown
files in `source/markdown`, each representing a single label. `dist/index.html`
contains a contatenated index of all these.
To seed this many listings, I started with my favorite genres then went through
the 1000 most popular words in the english language.
`rake seed_most_common_words` does this.
To seed even more labels, it's possible to run `rake seed_random` which queries
random words from the dictionary on a loop.
_Caveat_ The reason these inefficient seeding methods are used (searching random
words and scanning the results for labels) is that bandcamp doesn't offer an API
or even a good HTML page for searching labels, nevermind labels by genre. The
search page that is used to seed shows artists and labels in the same list.
Each request only shows 15 items, so the number of labels indexed per request is quite low.