PERFORMOUS(6)

πŸ“¦
version 1.3.1 Β· 6 versions
, in ubuntu resolute

🌸 PERFORMOUS(6) β€” the manual, but make it cute ✨

okay bestie, so this is the manual page for performous, living in section 6 of the manual (that's the Games section, iykyk πŸ’…). pull up a chair, grab a boba, and let's get into it πŸ§‹πŸ’–

πŸŽ€ NAME πŸŽ€

performous β€” the free music and rhythm game. that's it. that's the name. iconic behavior fr fr πŸ‘‘

✨ DESCRIPTION ✨

so like, Performous is a free cross-platform karaoke, band and dancing game?? one or more players perform a song and the game scores their performances based on timing and accuracy. no cap, it's literally just you, the mic, and the vibe check 🎀✨

it supports songs in UltraStar, Frets on Fire and StepMania formats. also β€” and this is the slay part β€” microphones and instruments from SingStar, Guitar Hero and Rock Band, plus some dance pads, are autodetected. plug in and go, bestie πŸ¦‹πŸŽΈ

🫢 if you're having trouble with the program (no songs found, audio not working, etc), try running it in a terminal! some useful debug information gets printed there. lowkey the terminal is your bestie in these moments πŸ˜­πŸ’»

πŸ’« Generic options:

  • -h [ --help ] β€” you are viewing it. hi!! hello!! this is the one πŸ‘‹πŸ’–
  • -l [ --log ] _arg_ β€” subsystem name or minimum level to log πŸͺ΅
  • -v [ --version ] β€” display version number 🏷️
  • --songlist _arg_ β€” save a list of songs in the specified folder πŸ“πŸ“

πŸŽ›οΈ Configuration options:

  • --audio _arg_ β€” specify an audio device to use πŸ”Š
  • --audiohelp β€” print audio related information 🎧
  • --jstest β€” utility to get joystick button mappings πŸ•ΉοΈ

any arguments without a switch are interpreted as song folders. periodt πŸ“‚

in-game navigation uses the following keys, bestie. memorize them, it's giving main character energy πŸ‘‘

🌈 Global shortcuts:

  • Left/Right/Up/Down/ β€” Change selected option/song β¬…οΈβž‘οΈβ¬†οΈβ¬‡οΈ
  • Enter β€” Enter selection ⏎
  • Esc β€” Exit the current screen/mode πŸšͺ
  • Alt+Enter β€” Switch between full screen and windowed modes πŸ–₯️
  • Pause or Ctrl+P β€” Pause audio/game ⏸️
  • Ctrl+Up/Down β€” Change audio volume πŸ”Š

🎡 Song selection:

  • Up/Down β€” Switch the sort order (song name, artist, edition, genre or song folder path) πŸ”€
  • Any text β€” Search for songs (write the text to find, uses regexp format) πŸ”βœ¨
  • Tab β€” Randomize songs (sort them again) 🎲
  • Ctrl+R β€” Refresh song list (reload from disk) πŸ”„
  • F4 β€” Enter jukebox mode (play songs entirely, hide song browser, allow seeking with Up/Down) πŸ“»

🎀 Singing screen:

  • Ctrl+Left/Right/Home β€” Fast forward or rewind the song ⏩βͺ
  • Enter β€” Skip long instrumental breaks, or get the grading instantly at the end of song 🏁
  • Ctrl+S β€” Toggle synth mode (synthesized tone for notes) 🎹
  • Ctrl+F1/F2 β€” Adjust audio/video sync. Use if the notes pass the black line at incorrect time. 🎬
  • Ctrl+F3/F4 β€” Adjust audio roundtrip latency. Use if the pitch wave does not match the notes, when you match your timing to what you hear. 🎧
  • Ctrl+F5/F6 β€” The total of USB controller latency combined with audio output latency. Adjust so that you can hit the notes best when playing by ear (not looking on screen). πŸ•ΉοΈ
  • Ctrl+K β€” Toggle karaoke mode (hide notes and scores) 🎢
  • Ctrl+W β€” Toggle pitch wave rendering (only when karaoke mode is disabled) 〰️
  • Ctrl+R β€” Hot reload song from disk (useful for making or repairing songs) πŸ› οΈ

🎚️ AUDIO DEVICE CONFIGURATION 🎚️

Performous normally autodetects microphones and playback devices correctly, but if this fails on your machine, you will need to configure them in the Audio Devices screen. Advanced configuration is possible through the command line β€” just remember to enter the configuration menu and press Ctrl+S to save them to your config file so that they don't need to be specified every time the program starts. save yourself the typing, bestie πŸ«ΆπŸ’Ύ

the list of available PortAudio devices is printed to the console, but it can also be seen from the GUI. two ways, same tea β˜•βœ¨

πŸ‘€ SEE ALSO πŸ‘€

you can find more information at:

and that's the whole page, bestie!! this gorgeous thing is Performous 1.3.1, dated December 2025 β€” go forth and slay those high notes πŸŽ€πŸ‘‘πŸ’…βœ¨

πŸ“¦ where this page comes from