TableTopManager

TableTopManager combines a music player with a soundboard. Great for tabletop games where both music and one-hit sound effects are required. Sound effects can be looped at a given interval, or randomly. Sound effect buttons can be played, stopped, faded in or out with one click, and all sound effect buttons on a page can do the same. Minimum and maximum fade volumes can be set for each sound effect button, and individual sound effect buttons can be set to ignore these commands.

Sound effect formats supported: .ogg .mp3

Music playlist formats supported: .ogg .mp3

Usage:

Place sound effects in: System music directory/TableTopManager/sound effects

Save files are stored in: System music directory/TableTopManager/saves

To assign or change a file on a sound effect button, right click on the desired button.

To change the label of a page button, right click on the desired page button.

Keyboard shortcuts:

• Space Bar: Play/Pause playlist
• Top Row 1-8 / Numpad 1-8: Change current page
• Escape: Open options / close current menu
• Return/Enter: Accept and close current menu

Disclaimers:

TableTopManagerhas been tested extensively on Windows, but not on Mac or Linux. Any bug reports are greatly appreciated.

Source code available here: https://github.com/nmpeckham/tabletopAudio

Pull requests and feedback welcome and encouraged!

See included changelog for full change history.

Changelog:

v1.1 "Inveniet" - Added DnD 5e quick reference tool

 - Name Change: TableTopAudio is now TableTopManager! Also check out the OG TableTop Audio: https://tabletopaudio.com/

 - Updated Unity to 2021.2.7f1

 - Open DnD quick reference with ~ key

 - The working folder for TableTopManager is now "Music/TableTopManager", instead of "Music/TableTopAudio"

 - New save file format. Saves made with previous versions of TableTopManager will likely not work

 - Added option to select which folders TTM should search for songs. Options -> Folders

 - High refresh rates are now supported. TableTopManager will target the maximum refresh rate of your monitor

 - Switched UI font to Lato. Lato includes 2163 font glyphs, reducing occurence of replacement glyphs (?) in place of unsupported characters

 - Added option to switch fullscreen mode between windowed, fullscreen windowed, and fullscreen exclusive

 - Music folders will now be searched recursively for songs

 - UI refresh. Many improvements in layout and consistency

 - Clicking on a fade in/out button while a fade in/out is active will cancel the active fade

 - Music fade in/out buttons now flash green when fade in/out is active

 - Save name input field now assumes text cursor focus when save panel is opened

 - Shuffle mode will no longer repeat the same song until all other songs have been played

 - Added option to sort a playlist alphabetically

 - Added tooltips to music control buttons

 - Further FFT refinements - # of bins and bin size adjusted. Now uses 10 bands, mathematically calculated to be 12% more appealing, 9 times out of 10

 - Song names no longer contain file extensions

 - Updated to most recent NLayer release (as of August 17th, 2023), which fixes many (unfortunately not all) mp3 decoder issues

 - Song duration is now shown for playlist items

 - Save names now respect case sensitivity on Linux

 - Added option to change outline color for SFX Buttons

 - Added support for ID3 tags, version 1.x and 2.x. Song names and artists will be properly displayed when available

 - Added search field to music playlist (ctrl/cmd+f shortcut)

 - Added "Play Next" option for playlist. Right click a song to open menu

 - Added new FFT visualizer: waterfall spectrum. Click on the FFT visualizer area to change type

 - Added error message when unsupported characters are present in a song title

 - Added option to clone a song in music playlist

 - Files or files contained in folders which start with "~" will be ignored

 - New shortcut: ctrl/cmd+f highlights playlist search field

 - New shortcut: ctrl/cmd+q shows/hides fps

 - Fixed bug where warning to overwrite save file wouldn't be shown if capitalization was different (platform specific)

 - Fixed bug where files with encoding errors would cause the buffer to play repeatedly

 - Fixed bug where file lock would not be released after playing a song until program was closed

 - Fixed bug where crossfade times were consistently longer by a factor of 1.2 seconds

 - Fixed bug where renaming a song in it's folder would cause music incorrect song to pley when selecting an item

 - Fixed bug where pressing Esc wouldn't exit SFX button menu after entering "select file" menu

 - Fixed tooltips becoming stuck to edge of screen

 - Fixed bug where last song in a playlist would never be selected when shuffle was active

 - Fixed bug where re-ordering songs could result in incorrect song playing when shuffle disabled

 - Fixed bug where music volume wouldn't be displayed linearly

 - Fixed bug where pressing spacebar wouldn't pause songs in certain cases

 - Fixed bug that could cause freeze when only one song in music playlist

 - Fixed bug where error messages would block interface

 - Fixed bug where pause button didn't turn orange when using space bar to pause

 - Fixed bug where FFT display textures could be incorrectly scaled for loud music intensities

 - Fixed logarithmic volume control not being correctly applied to music playlist items and sfx buttons

 - Fixed bug that could (rarely) cause playlist to skip to next song if an mp3 encoding artifact was encountered

 - Fixed bug that would cause music playlist audio to become glitched if crossfade was changed to disabled while crossfade was in progress and another song was immediately started. This was an absolute nightmare to trackdown and fix

 - Fixed bug where text input wasn't assumed on all fields when editing

 - Fixed bug where mp3 encoding errors could cause audio samples to loop repeatedly

 - Fixed many, many more bugs. Added a few to fix in the future