https://github.com/jcraigk/phishin
An archive of live Phish audio
https://github.com/jcraigk/phishin
music-library phish rails soundmanager2
Last synced: 3 months ago
JSON representation
An archive of live Phish audio
- Host: GitHub
- URL: https://github.com/jcraigk/phishin
- Owner: jcraigk
- License: mit
- Created: 2013-11-12T07:55:10.000Z (almost 12 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T05:39:33.000Z (about 1 year ago)
- Last Synced: 2024-10-29T23:02:53.204Z (about 1 year ago)
- Topics: music-library, phish, rails, soundmanager2
- Language: Ruby
- Homepage: http://phish.in
- Size: 4.57 MB
- Stars: 68
- Watchers: 9
- Forks: 10
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- jimsghstars - jcraigk/phishin - An archive of live Phish audience recordings (Ruby)
README
Phish.in is an open source archive of live Phish audience recordings.
Ruby on Rails and Grape API wrap a PostgreSQL database on the backend. There's a [web frontend](https://phish.in) written in React for browsing and playing audio content as well as a [JSON API](https://petstore.swagger.io/?url=https%3A%2F%2Fphish.in/api/v2/swagger_doc) for accessing content programmatically.
All audio is provided in MP3 format. More formats and sources may be made available at a later time. Assets including audio MP3s, waveform PNGs, and album art JPEGs are served directly from the web server and cached via CloudFlare CDN.
Join the [Discord](https://discord.gg/KZWFsNN) to discuss content and development or install the [Discord Bot](https://github.com/jcraigk/phishin-discord) to query setlists and play music in voice channels.
## Developer Setup
1. Install [Docker](https://www.docker.com/)
2. Clone the repo to your local machine
3. Create a `.env` file at the root of the repository
4. Run `make services`
5. Download the [Development SQL File](https://www.dropbox.com/scl/fi/6zv4bzxxcjgv3ouv8d3ek/phishin-dev.sql?rlkey=4trafp2vxcgc1iuuq36yhl9gc) and import it:
```bash
# Copy SQL dump into PG container and run it
$ docker cp /path/to/phishin-dev.sql phishin-pg-1:/docker-entrypoint-initdb.d/data.sql
$ docker exec -u postgres phishin-pg-1 createdb phishin_development
$ docker exec -u postgres phishin-pg-1 psql -d phishin_development -f docker-entrypoint-initdb.d/data.sql
```
4. To present production content locally during development, set `PRODUCTION_CONTENT=true` in your local `.env` file.
5. If you want to run the Postgres database in Docker and develop the app natively (recommended), you can spin it up like this:
Install the correct ruby version:
```bash
$ brew install rbenv # if not already installed
$ rbenv install 3.4.5 # or current version in `Gemfile`
$ rbenv local 3.4.5
```
Install dependencies:
```bash
$ gem install bundler foreman # if bundler and/or foreman are not already installed
$ bundle install
$ yarn install
```
Run the app:
```bash
$ make dev
```
If you are on a Mac ARM and the `ruby-audio` gem fails to install, see the Troubleshooting section below.
Alternatively, if you prefer to develop completely in Docker, build and start the containers like this:
```bash
$ make up
```
## Testing
To run the specs in Docker:
```bash
$ make spec
```
To run the specs natively:
```bash
$ make services
$ bundle exec rails db:setup RAILS_ENV=test
$ bundle exec rspec
```
## Importing Content
The content import process uses the [Phish.net API](https://docs.phish.net/) for setlists. You must first obtain an API key from them and assign it to the environment variable `PNET_API_KEY` in `.env`.
If running the Rails app natively, you may need to install `ffmpeg`.
To import a new show or replace an existing one, name the MP3s according to the import format (`I 01 Harry Hood.mp3`) and place them in a folder named by date (`2018-08-12`). Place this folder in `./content/import` and run the following command (`make bash` first if you use Docker):
```bash
bundle exec rails shows:import
```
Use the interactive CLI to finish the import process then set `PRODUCTION_CONTENT=false`, restart the server, and visit `http://localhost:3000/` to verify the import.
## Troubleshooting (Appendix)
### Postgres Connection Issues
- If you get a `NoDatabaseError` or `connection to server at "localhost" failed`, make sure:
- No other Postgres server is running on your Mac (use `brew services list`, `ps aux | grep postgres`, or `lsof -i :5432`).
- Stop any native Postgres with `brew services stop postgresql` or by quitting Postgres.app.
- After stopping, restart your Docker Postgres:
```sh
make services
```
- You should see your database with:
```sh
psql -h localhost -U postgres -l
```
- If you do not see `phishin_development` in the list, re-import your SQL dump as described above.
### Webpack Dev Server Port Conflict
- If you see an error like `EADDRINUSE: address already in use 127.0.0.1:3035`, run:
```sh
lsof -i :3035
```
and kill any stray `node` processes:
```sh
kill -9
```
### Mac ARM: ruby-audio Gem Installation
- If you are on a Mac ARM and the `ruby-audio` gem fails to install, try the following:
```sh
brew install libsndfile
gem install ruby-audio -- --with-sndfile-dir=/opt/homebrew/opt/libsndfile
```
## Contributions
Forked with permission in 2012 from [StreamPhish](https://github.com/jeffplang/streamphish/) by Jeff Lang.
Software and content maintained by [Justin Craig-Kuhn](https://github.com/jcraigk).