README

pipeline coverage

Installation

composer create-project arnapou/atcd

packagist 👉️ arnapou/atcd

ATCD stands for "Audio Trip Choreography Discord".

This repository is not affiliated with ATCD itself: this is a personal project.

Audio Trip is a VR (virtual reality) rhythm game which can help you to do some workout with fun, while "dancing".

PHP backend, no framework, PSR respectful
almost no JS, fast, simple, web basics
Pico CSS fuchsia for the front design
original ats and ogg files are stored into public/files (cf. compose.override.dist.yaml)
no database: all is indexed automatically into a file cache (only a few hundred of songs)
zip files are served on-demand as a pure stream, small memory footprint, thanks to arnapou/zip lib

URI	Description	filters (*)
`GET` `/`	home
`GET` `/songs`	song list where you can filter and download songs	✓
`GET` `/songs.json`	same as `/songs` but as JSON	✓
`GET` `/analyze`	basic text endpoint which can help fixing `ats` and `ogg` files
`GET` `/download/{url-safe-base64}.zip`	`zip` stream download of one song
`GET` `/download/all.zip`	`zip` stream download of song list	✓
`GET` `/download/playlist.atl`	`atl` (AT playlist) file of song list	✓

*() filters**: these are accepted parameters in the query string.

Filter	Type	Description	Example
`q`	`string`	Query on song (artist + title)	`q=dragons`
`p`	`string`	Playlist name	`p=My+Playlist`
`t`	`string[]`	List of Choreo types	`t[]=Beginner`
`c`	`string[]`	List of Choreographers	`c[]=OkDiSpLaY`
`s`	`string[]`	List of scenes	`s[]=Anemone`
`z`	`boolean`	Whether to reset the scenes to "Universal"	`z=0`
`f`	`string`	The field to sort on, see the enum Sort	`f=song1`
`d`	`YYYY-MM-DD`	Recent song from {date}	`d=2022-01-01`

Home

Song list

Date	Ref	8.4
10/01/2025	1.x, main	×