⚠️ You must have a Discogs account to run this project.

TropoDisc helps you manage your audio library from your Discogs collection. It was developed mainly for the personal use of its author, and made available under the GPL license.

ℹ️ It can also be used to highlight the location of albums via LED 💡 strips... but that's another story 😃

Screenshots

Quick start

TropoDisc can be used as a simple wrapper for your Discogs collection, or do a little more by communicating with your audio library Arduino server to highlight the location of your albums using leds. That's how I use it, but it needs more work. We will focus here on the simplest way:

$ git clone https://github.com/esaracco/tropodisc.git
$ cd tropodisc/
$ yarn
$ cp .env.sample .env
$ vim .env
..

There is a lot of settings constants, but only two are really required:

• REACT_APP_DISCOGS_USER: your Discogs account user.
• REACT_APP_DISCOGS_TOKEN: your Discogs token.

More details here.

..
$ yarn build
$ sudo yarn global add serve
$ serve -s build

Thats it 😃 TropoDisc will be available on http://localhost:3000

To take full advantage of it

TropoDisc has been designed to handle three custom Discogs user fields:

• place (textarea, 1 line): The physical position of your album in your audio library.
• price (textarea, 1 line): The purchase price of your album.
• styles (textarea, 1 line): This field is for your own albums styles, separated by comma. This makes it possible to have something simpler than the plethora of existing Discogs styles...

First you have to create these fields from your Discogs account. More details here. Once these fields are created, edit the .env file to set the following constants:

• REACT_APP_DISCOGS_FIELD_PLACE
• REACT_APP_DISCOGS_FIELD_PRICE
• REACT_APP_DISCOGS_FIELD_STYLES
• REACT_APP_DISCOGS_FIELDS_REQUIRED

Then restart the app server and re-sync your collection by clicking the Synchronize 🔄 button from the TropoDisc menu.

Docker

To build and run the Docker, do the following:

$ cp .env.sample .env
$ vim .env
..

Customize .env as explained above, then:

..
$ docker build -t tropodisc:prod .
$ docker run -it --rm -p [yourlocalport]:3000 tropodisc:prod

Finally, connect to http://localhost:[yourlocalport] to use it.

🎉 Have fun!