vinyl-shelf-finder

vinyl-shelf-finder copied to clipboard

= Vinyl Shelf Finder

== About image::https://valentingalea.github.io/vinyl-shelf-finder/img/app.png[Screenshot, 256, 256]

Vinyltin - is a app that manages a Discogs user records collection and helps locate them in shelving cabinets - provided a certain ordering is maintained.

== Features WIP and very primitive

• web app powered by Node.js
• custom searches in a Discogs collection
• cover art display with optional image caching
• Last.fm integration (as well as local database backup)
• interfaces with a hardware pan-tilt laser pointer

== Installation DISCLAMER: for the brave, no guarantees

=== Node.js

Install https://nodejs.org/en/download/[Node.js] 6.x+

Clone / download this repository; navigate to the app folder

cd app

Install all the dependencies

npm install

=== Setup

Navigate to app/src and edit the files discogs_secret.js (and optionally last_fm_secret.js) with your personal account details.

=== Start

node app.js

the sqlite database module may not work for all platforms, it can be disabled with

node app.js --no-db

the Last.fm integration can be disabled with

node app.js --no-lastfm

== Usage

Navigate with any browser to

http://localhost:8080

== Hardware

The app can interact with a Raspberry Pi that has mounted a pan-tilt with a laser pointer

• https://shop.pimoroni.com/products/pan-tilt-hat[pan-tilt HAT module]
• http://www.ebay.co.uk/itm/650nm-Laser-sensor-Module-6mm-5V-5mW-Red-Laser-Dot-Diode-Arduino-Raspberry-Pi/181973250215[laser pointer module]

== Documentation

There is a https://valentingalea.github.io/vinyl-shelf-finder/[micro-website] setup via the docs folder

== Contact

Reach me on https://twitter.com/valentin_galea[twitter]