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 |
---|---|
Download the version that matches your operating system and extract the contents to a folder of your choice.
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
- Follow prompt if this is your first time running AmbientDJ: This will tell AmbientDJ where to find your music files.
Left click
on a mood to create a playlist of songs which have that mood and/orRight click
on a mood to create a playlist of songs which DO NOT have that mood
Include Mood | Exclude Mood |
---|---|
- Click
Activate
to start playing proposed playlist - Use
Play\Pause
andNext Song
to control the music - Repeat steps
2 - 4
to generate a new playlist and overwite the current playlist
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.
Sam Hermes | GitHub | LinkedIn | Twitter