michael-f-ellis/infinite-etudes

Ear training for your fingers

Infinite Etudes

infinite-etudes generates ear training exercises for instrumentalists.

infinite-etudes incorporates a web server and provides a simple user interface which allows the user to choose a key, a scale pattern and an instrument sound and play a freshly-generated etude in the web browser. A public demo instance is running at

https://etudes.ellisandgrant.com

Installation

You need to have Go installed to build and test infinite-etudes. Get it from https://golang.org/dl/ .

After installing Go, do

  go get github.com/Michael-F-Ellis/infinite-etudes
  cd $GOPATH/src/github.com/Michael-F-Ellis/infinite-etudes
  go test
  go install

Then run infinite-etudes -h for options and usage instructions.

Serving HTTPS

When serving on port 443, you'll need to set 2 environment variables, IETUDE_CERT_PATH and IETUDE_CERTKEY_PATH to point to the certificates. If you're serving from a linux with systemctl, a typical service file looks like the following:

[Unit]
Description=Infinite Etudes server
After=network.target

[Service]
Type=simple
User=mellis
WorkingDirectory=/home/mellis/ietudes
# Always attempt to renew the certificate before (re)starting infinite-etudes
ExecStartPre=+/usr/bin/certbot renew
# infinite-etudes needs two environment variables that give full paths to the certificate
# fullchain and key files.
Environment="IETUDE_CERT_PATH=/etc/letsencrypt/live/etudes.ellisandgrant.com/fullchain.pem"
Environment="IETUDE_CERTKEY_PATH=/etc/letsencrypt/live/etudes.ellisandgrant.com/privkey.pem"
# run infinite-etudes as an https server
ExecStart=/home/mellis/go/bin/infinite-etudes -p :443
# Ensure that the process is always restarted on failure or if terminated by a signal
# A 5 second restart delay is used to reduce the possibility of thrashing if
# something is badly wrong.
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

In the above, you'll need to replace mellis and etudes.ellisandgrant.com with your user name and host name, respectively.

Also, you'll need to arrange for the infinite-etudes executable to have permission to read the CERT files and bind to port 443. If you use something like

sudo setcap sudo setcap 'cap_net_bind_service,cap_dac_read_search=+ep' /home/mellis/go/bin/infinite-etudes

you'll need to re-run that command any time you rebuild the executable.

infinite-etudes's Issues

Fix TestBadEtudeRequest

The URL's used in this test should result in a response with StatusBadRequest. Instead, the response is nil and there is an
EOF error.

Assignees: @Michael-F-Ellis
Labels:

infinite-etudes/server_test.go

Line 127 in e49a011

if resp.StatusCode != http.StatusBadRequest {

Range adjustment

Presently, each instrument has an associated range that corresponds to the lowest and highest notes that can typically be played on that instrument.

This keeps it simple in terms of user choices but there are times when one might want to work on a smaller part of the instrument's range.