Readback is how WCBN manages playlists, schedules, personnel, and trainees.
In order to work on Readback, you’ll need to install Ruby, Yarn, Postgres, and Redis. If you’re on a Mac, you can follow these instructions directly. Otherwise, hopefully they’re useful as Google fodder.
The easiest way to install developer tools on macOS is Homebrew. Install it following the instructions on their website
The package manager for Windows known as Chocolately may (or may not) be useful.
We recommend using rbenv to install the necessary version of Ruby without conflicting with other things that use ruby.
brew install rbenv
cd readback
rbenv install # This installs the version specified by the GemfileWe use yarn to manage JavaScript dependencies. Install it by following the instructions on their website
PostgreSQL is our database. It is possible to install PostgreSQL using Homebrew, but it can be difficult to configure. We recommend using Postgres.app
Redis is a fast key-value store that we use for caching and for keeping track of background jobs that need to be done. Install Redis using Homebrew and configure it to load when your computer starts. It’s super lightweight, so there’s no reason not to configure it to do so.
brew install redis
ln -sfv /usr/local/opt/redis/*.plist ~/Library/LaunchAgentsOvermind will run all the processes needed for a developement server of Readback. Install it as follows:
brew install overmindAfter checking out the repo, run bin/setup to install dependencies.
Start the development server by running overmind start. You can also run bin/rails console for an interactive prompt that will allow you to experiment.
Navigate to http://localhost:5000
Bug reports and pull requests are welcome on GitHub at https://github.com/cbothner/readback. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
The project is available as open source under the terms of the MIT License.