Skip to content

Latest commit

 

History

History
86 lines (61 loc) · 5.23 KB

README.md

File metadata and controls

86 lines (61 loc) · 5.23 KB

На русском 👈

Dungeon DJ

This is a music management tool for tabletop role-playing games.
Designed for use with the foobar2000 media player due to the fade in/out functionality and nice features.

Description

Basically you just play your playlists for the game situations via hotkeys. Like press B for Battle music, press T for Tavern and so on. The player stays hidden and don't bother your small laptop screen. Music can be stored as audio files or youtube-links. Also the fade in/out foobars function works like a charm.

For Windows use only.

How to use

  1. Download DungeonDJ with foobar included, unzip it
  2. Put your music in the /music subfolders and name that folders whatever you like. The first letter of the name of each folder stands for a key that you need to press to play music from that folder. Examples included.
  3. Run play.exe, don't mind Windows Defender. It dislikes autohotkeys scripts.
  4. Press Alt and the chosen Key for music
If you want to install and setup foobar on your own
  1. Download DungeonDJ without foobar, unzip it
  2. Download foobar2000
  3. Install foobar to DungeonDJ/foobar2000 folder or specify path to .exe in the config.ini file.
  4. Put your music in the /music subfolders and name that folders whatever you like. The first letter of the name of each folder stands for a key that you need to press to play music from that folder. Examples included.
  5. Run play.exe, don't mind Windows Defender. It dislikes autohotkeys scripts.
  6. Press Alt and the chosen Key for music
  7. Optional. Install foobar youtube-component if you want to add music from the Youtube videos.
  8. Optional. Check out recommended foobar settings for the best experience.

Additional hotkeys

Alt + 1 → play/pause
Alt + 2 → play next track in the current playlist
Alt + 3 → show/hide player
Alt + 4 → show a cheat sheet with keys and music folders
Alt + Y → show youtube video search (only if you downloaded foobar with DungeonDJ. Otherwise, you need to enable this hotkey in settings)

foobar settings

Note If you downloaded foobar with DungeonDJ — this settings already apllied.

  • File → Preferences → Playback → Output → Fading → check «Enable smooth seeking...» & set «Manual track change» slider to whatever your like, 4000ms recommended. That makes music changes like in videogames, so nice and smooth 🤙
  • File → Preferences → Display → Default User Interface → Background and Notifications → turn on «Minimize hides, close exits» if you want to minimize foobar
  • File → Preferences → Shell Integration → turn off «Bring to front when adding new files» if you want foobar to stay hidden during Dungeons track changes
  • Playback → Order → set «Random» if you want to run music from folder in random order
  • File → Preferences → Keyboard Shortcuts → Add new → set hotkey for View/Youtube Source/Search on Site action if you want to fast access to this brilliant function

Music from Youtube

foobar is such a great thing due to possibility of mixing local files and youtube videos in one playlist. Give it a try!

  1. Download component. For me version foo_youtube_3.9_beta2 works fine.
  2. Open foobar → File → Preferences → Components → Install → dowloaded file.

Now you go View → Youtube Source → Search on Site → type something like «ambient music» → click it to start music with smooth fade in effect!
But even on top of that you may save youtube video link as a file! Just right click on video → foobar2000 → File Operations → Copy to → choose your DungeonDJ music subfolder. Name track as you want but you need to add .foo_youtube extension in the end.

Screenshots “” “”

Options

  • You may turn off the now-playing notifications in the config.ini file.
  • Change language between en or ru. Impact only notifications for now 😉
  • Change key for the combination if you don't like Alt. Use ahk codes

More fun

Actually I made it for my custom keyboard so you may also like this idea. With some VIA or Vial you can become the real Dungeon DJ. Personally, I use DOIO KB16-01:

image

Credits

These people are real titans, on whose shoulders I modestly stand.
foobar2000 developers
Autohotkey developers

Also authors of great Pleasant Notify library