Skip to content

klitscher/adj

Repository files navigation

AmbientDJ (adj)

Check out our landing page!

AmbientDJ is a tool for Dungeons and Dragons DMs to create a more immersive experience for their players. AmbientDJ allows DMs to create a playlist on the fly that fits the "mood" of whatever situation is currently happening: danger, battle, tavern, city, climax etc. AmbientDJ will then generate a playlist of the user's songs which match those "moods" and commence playing it.

Initial Setup Main Screen

Installation

Download the version that matches your operating system and extract the contents to a folder of your choice.

Usage

Start AmbientDJ

Move into the adj_package folder which contains all the files. Then do the following depeding on you operating system:

Linux

user$ ./adjrun

Mac

Double click adjrun
In order to run on mac, the user must allow execution of the dynamic libraries in the Security and Privacy section of the System Preferences application

Windows

Double click adj.exe

Use AmbientDJ

  1. Follow prompt if this is your first time running AmbientDJ: This will tell AmbientDJ where to find your music files.
  2. Left click on a mood to create a playlist of songs which have that mood and/or Right click on a mood to create a playlist of songs which DO NOT have that mood
Include Mood Exclude Mood
  1. Click Activate to start playing proposed playlist
  2. Use Play\Pause and Next Song to control the music
  3. Repeat steps 2 - 4 to generate a new playlist and overwite the current playlist

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

External Libraries

  1. BASS
  2. Kivy

Authors

Sam Hermes | GitHub | LinkedIn | Twitter

Kyle Litscher | LinkedIn | Twitter

Rory Fahy