potatoslicer 0.1.0

Potatoslicer — tracker-style pattern sequencer with multi-engine audio synthesis

Potatoslicer Sequencer

A tracker-style pattern sequencer built with Pygame-CE. Create and edit pattern-based songs using the built-in synthesizer engine with real-time audio playback.

Requirements

• Python 3.10+
• System packages: libportaudio2, python3-venv
• Python packages: pygame-ce, numpy, sounddevice

Setup

make setup   # installs system deps, creates venv, installs Python packages

Running

make run

Keyboard Shortcuts

Navigation

Key	Action
Arrow keys	Move selection in pattern grid
Tab / Shift+Tab	Next / previous channel
Page Up/Down	Scroll grid
Scroll wheel	Scroll grid or sidebars
Esc	Clear selection / close modal

Playback

Key	Action
Space	Play / pause

Note Entry

Key	Action
A-G	Set note letter
0-9	Set octave
# or S	Sharp
Enter	Confirm note, move cursor down
Delete / Backspace	Clear cell
-	Note-off (---)
+	Chord mode
I	Cycle instrument

Editing

Key	Action
Ctrl+C / Ctrl+V	Copy / paste cell
Ctrl+Z	Undo
Ctrl+S	Save song

Other

Key	Action
? or F1	Toggle help
F2	Open piano keyboard

CapsLock remapped to Control at the OS level is supported.

Song Tools

make list-songs              # list available songs
make play-song SONG=groove   # play a song from the CLI
make song-info SONG=groove   # show song details

Architecture

See ARCHITECTURE.md for details on the codebase structure, audio pipeline, and data flow.