explaingit

skorotkiewicz/psycho-odin

Analysis updated 2026-05-18

8OdinAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A music-driven arcade racing game that analyzes any song you load and generates a playable 3D roller-coaster track out of its rhythm and dynamics.

Mindmap

mindmap
  root((repo))
    What it does
      Analyzes songs
      Generates 3D tracks
      Scores your run
    Tech stack
      Odin
      raylib
    Use cases
      Race your own music
      Chase personal bests
      Build from source
    Audience
      Music game fans
      Arcade players

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Load a song from your own music library and race down a track generated from its rhythm.

USE CASE 2

Compete for personal best scores and times on the same song.

USE CASE 3

Build the game from source using the Odin toolchain on Linux, macOS, or Windows.

What is it built with?

Odinraylib

How does it compare?

skorotkiewicz/psycho-odinbuleeto/runaodin-lang/odin
Stars81710,306
LanguageOdinOdinOdin
Setup difficultymoderatehardmoderate
Complexity2/55/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Odin compiler, raylib, and build tools like just, curl, tar, and jq, the first run downloads Odin automatically.

Free to use, modify, and distribute for any purpose, as long as you keep the original copyright notice.

In plain English

PSYCHO is a game that turns any song you own into a playable 3D racing track. Before the ride starts, it listens to the whole song and analyzes its rhythm, spectrum, dynamics, and tempo, then builds a complete closed loop course out of that analysis. Quiet parts of the song become calm climbs in cool colors, while loud, energetic parts become fast descents in hot colors, and the track always loops back smoothly to where it started. Once the track is generated, you race down it, steering with the mouse or keyboard, collecting matching colors to build a score multiplier, dodging hazards, and grabbing boosts for a temporary double score bonus. The background sky also reacts to the music with glowing shapes and rays. Every completed run is saved with your score and time, and the game tracks personal best runs per song. The game is written in the Odin programming language using the raylib graphics library, and supports Linux, macOS, and Windows. It accepts common audio formats including WAV, MP3, OGG, and FLAC. The first time you load a song, the game performs a deeper analysis to build its track, and saves that generated map to a local cache folder based on the song's content, so later plays of the same song start instantly. Installing it involves either using a build tool called just, which handles downloading the Odin compiler automatically, or building directly if you already have Odin and raylib installed. Settings like mouse sensitivity, maximum speed, music volume, and visual effect strength can be adjusted in a configuration file, and most of them can also be changed live during a run with keyboard shortcuts. This is aimed at players who enjoy music-driven arcade games and want a personal, generated racing experience built from their own music library, inspired by the older game AudioSurf.

Copy-paste prompts

Prompt 1
Help me install the just build tool and compile psycho-odin from source.
Prompt 2
Explain how to run psycho-odin with my own MP3 or FLAC file.
Prompt 3
Show me how to adjust the visual effect strength and mouse sensitivity in config.toml.

Frequently asked questions

What is psycho-odin?

A music-driven arcade racing game that analyzes any song you load and generates a playable 3D roller-coaster track out of its rhythm and dynamics.

What language is psycho-odin written in?

Mainly Odin. The stack also includes Odin, raylib.

What license does psycho-odin use?

Free to use, modify, and distribute for any purpose, as long as you keep the original copyright notice.

How hard is psycho-odin to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is psycho-odin for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.