Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Logo

Camp Explorer

This repository contains the code for the Camp Explorer website and Chrome extension. On Bandcamp you're only able to search for albums using a single tag but this extension enables you to search for albums with any number of matching tags.

Screenshot

Client usage

Type in a search criteria and press add. Repeat for all criterias you want to find albums for. Click the x to the right of the added search criteria to remove it.

When you find an interesting album, click on it to jump to its page.

Note that search criterias that have not been cached previously might take a while for the server to cache up.

Implementation

The app is made up of two clients (web and Chrome app). The chrome app is served by nginx. The backend api uses Node.js. And Docker is used for running and managing the whole thing.

When user requests a tag the server searches either returns the cached results or if they don't exist it puts the request in queue to be searched and cached. Cache is saved to an ElasticSearch database that also handles the filtering on request.

The server continously recaches tags in order of oldest first with a minute delay until it starts next tag. It's possible to start the server with an initial seed-tag. It then caches up all albums for the seed and then caches all the tags that each of those albums had. Note that this will take a few hours.

Statistics of the server is also hosted to see the state of caching, just add /statistics to see it.

Steps to run locally

  1. Install Docker if you don't already have it
  2. Run docker-compose up. This will require usage of port 80 but you can change that in the docker-compose.yml configuration.
  3. Go to localhost

Known Issues

  • It isn't possible to get all albums from Bandcamp so some albums might be missing.

Release Notes

2.0.0

  • New web-client
  • Added upgrade message to app
  • Major changes to how searching works compared to older version of Chrome app, should give a 10x increase in results and return them much faster if they've already been cached.

1.0.3

  • Fixed rare error when having multiple tags

1.0.2

  • Changed Bandcamp throttling message.

1.0.1

  • Fixed app not handling 503 (Service unavailable) errors which occurs when searching Bandcamp too often. App now retries multiple times with a longer timeout for each try. A graphical icon next to the search spinner indicates when this is happening.

1.0.0

  • Initial release

About

Website and Chrome extension that enables you to search Bandcamp with multiple tags

Resources

License

Releases

No releases published

Packages

No packages published

Languages