apricote/Listory
1
0
Fork 0
mirror of https://github.com/apricote/Listory.git synced 2026-01-13 21:21:02 +00:00
Code Issues Projects Releases Packages Wiki Activity
Track your Spotify listens
655 commits 15 branches 75 tags 62 MiB
Find a file
Julian Tölle 0a64df293b chore(deps): group pino renovate prs 
They mostly depend on eachother and cause issues if not kept in sync.
2022-06-25 15:28:05 +02:00
.github/workflows ci: verify that frontend still builds 2022-06-25 14:54:59 +02:00
assets feat(frontend): add favicon 2020-05-14 03:10:24 +02:00
charts/listory chore(release): 1.16.4 [skip ci] 2022-06-23 16:31:21 +00:00
frontend chore(frontend): migrate to tailwindcss v3 2022-06-25 15:14:46 +02:00
observability chore(deps): update dependency prom/prometheus to v2.36.2 2022-06-21 06:21:24 +00:00
src fix(api): send trace context to sentry 2022-06-23 18:26:42 +02:00
test test: create initial unit tests 2021-07-18 21:57:38 +02:00
.dockerignore feat(frontend): add footer with version number 2021-05-24 19:00:07 +02:00
.env.sample feat: add docs and polish 2020-05-03 21:10:31 +02:00
.eslintrc.js chore(lint): switch to eslint 2021-05-25 18:12:42 +02:00
.gitignore feat: serve frontend from api container in prod build 2020-05-03 21:10:31 +02:00
.prettierignore style(helm): run prettier and add templates to prettierignore 2020-11-21 15:53:51 +01:00
.releaserc.yml fix(ci): Helm chart still not properly released 2020-05-12 02:06:40 +02:00
CHANGELOG.md chore(release): 1.16.4 [skip ci] 2022-06-23 16:31:21 +00:00
docker-compose.yml chore(frontend): remove cra workaround no longer needed 2022-06-25 15:14:46 +02:00
Dockerfile chore(deps): update node.js to v18 2022-06-19 14:26:53 +02:00
LICENSE feat: add docs and polish 2020-05-03 21:10:31 +02:00
nest-cli.json feat(api): setup nestjs 2020-05-03 21:00:20 +02:00
package-lock.json chore(deps): update dependency eslint-plugin-jsx-a11y to v6.6.0 2022-06-24 20:23:39 +00:00
package.json chore(deps): update dependency eslint-plugin-jsx-a11y to v6.6.0 2022-06-24 20:23:39 +00:00
README.md feat(observability): Replace Prometheus package with OpenTelemetry 2022-06-18 17:48:16 +02:00
renovate.json chore(deps): group pino renovate prs 2022-06-25 15:28:05 +02:00
tsconfig.build.json feat(api): setup nestjs 2020-05-03 21:00:20 +02:00
tsconfig.json build: fix issue where frontend was included in backend tsc build 2021-06-22 21:06:35 +02:00

README.md

Listory

Login with Spotify and Listory will save all tracks you listen to.

Installation

End-user Installation of Listory is not yet fully supported and the docs in this section are not complete.

Configuration

All configuration must be set as environment variables. Default values are added in bold, values that are required are marked with Required.

Application

  • PORT: 3000: Port the webserver will listen on.
  • APP_URL: http://localhost:3000: Public URL of the Application, is used to generate Links.

Authentication

  • JWT_SECRET: Required, used to sign the JWTs.
  • JWT_ALGORITHM: HS256: Algorithm used to sign the JWTs. One of HS256, HS384, HS512
  • JWT_EXPIRATION_TIME: 1d: Lifetime of signed JWTs. Accepts strings like 1d, 2h, 15m.

Spotify

  • SPOTIFY_CLIENT_ID: Required, Spotify App Client ID
  • SPOTIFY_CLIENT_SECRET: Required, Spotify App Client Secret
  • SPOTIFY_FETCH_INTERVAL_SEC: 60: Interval for fetching recently listened tracks from Spotify.
  • SPOTIFY_UPDATE_INTERVAL_SEC: 60: Interval for updating previously imported music library entities (artist, album, track). Raise this number if you often hit the Spotify API Ratelimit.
  • SPOTIFY_WEB_API_URL: https://api.spotify.com/: Spotify WEB API Endpoint.
  • SPOTIFY_AUTH_API_URL: https://accounts.spotify.com/: Spotify Authentication API Endpoint.
  • SPOTIFY_USER_FILTER: "": If set, only allow Spotify users with these ids to access the app. If empty, allow all users to access the app. Seperate ids with , eg.: 231421323123,other_id.

Database

  • DB_HOST: Required, Database host
  • DB_USERNAME: Required, Database username
  • DB_PASSWORD: Required, Database password
  • DB_DATABASE: Required, Database database
  • DB_POOL_MAX: 50, max concurrent database connections

Sentry

You can use Sentry to automatically detect and report any exceptions thrown.

  • SENTRY_ENABLED: false, Set to true to enable Sentry.
  • SENTRY_DSN: Required, but only if SENTRY_ENABLED is true. The DSN for your Sentry project.

OpenTelemetry

We use OpenTelemetry to provide observability into Listory API.

The metrics will be exposed on a seperate port at :9464/metrics. Make sure that this endpoint is not publicly available in your deployment.

Traces will be sent to the specified endpoint.

To use observability tools locally, check out docker-compose setup in observability/.

  • OTEL_METRICS_ENABLED: false, Set to true to activate metrics.
  • OTEL_TRACES_ENABLED: false, Set to true to activate traces.
  • OTEL_EXPORTER_OTLP_ENDPOINT: Required, but only if OTEL_TRACES_ENABLED is true. The endpoint that traces are sent to, see OpenTelemetry docs
  • OTEL_EXPORTER_PROMETHEUS_PORT: 9464, Set to configure non-standard port for Prometheus metrics

Development

Configure Spotify API Access

Copy the file .env.sample to .env and add your Spotify API Key.

Starting the application

We use docker-compose to provide a full local development environment.

$ docker-compose up

You can now access the frontend at http://localhost:3000 and the API at http://localhost:3000/api.

Frontend and API will automatically reload on any code changes.

Test

# unit tests
$ npm run test

# e2e tests
$ npm run test:e2e

# test coverage
$ npm run test:cov

License

Listory is MIT licensed.