Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/samuri51/chillybot

a turntable bot created by a moderator of straight_chillin11
https://github.com/samuri51/chillybot

Last synced: about 1 month ago
JSON representation

a turntable bot created by a moderator of straight_chillin11

Awesome Lists containing this project

README

        

# Features
---------------
Queue\
afk limit\
afk audience limit(separate from afk limit, both can be toggled on and off)\
song length limit\
ban list\
master Id list\
song play limit\
vote skipping\
room greeting\
add songs to your bots playlist\
randomize your bots playlist\
Vip list (for when special guests come to dj)\
autodjing when 3 or less djs or when no djs on stage\
skips stuck songs and gives others 20 seconds to skip\
very noninstrusive, only enforces the queue when people are in the queue\
(very easy to make it enforce it all the time, just ask)\
ability to toggle just about everything\
very easy to use! entirely script based just download node, run the script and you're off!

*now with the ability to automatically reconnect to your turntable room after losing internet connection!\
*simply install the latest version of ttapi to do it!

For a full list of commands, please consult the commands.txt file(does not contain all features, just commands).

This is a bot for straight chillin on turntable.fm but the code can be used in any room.
If you notice any bugs or have any questions, comments, or concerns feel free to open an issue
and i will try to respond.

-----------------------------------------------------------------------------------
This bot uses the turntable api by alain gilbert which can be found here:

https://github.com/alaingilbert/Turntable-API
------------------------------------------------------------------------------------

# Installation:
1. download node.js from nodejs.org

2. Install dependencies

```
npm install ttapi
```

3. create a new account on turntable.fm, this will be your bot. login as the bot and get it's user id and auth and enter that into the script in the setup section.
make sure that you do this in the room that you want the bot to show up in as every room has a different room id. In order to find this information out download
the bookmark that has a link provided for it below.

4. open up the script (you can do this with notepad or notepad++, i recommend notepad++) and enter in the data it asks for in the setup section at the top of the script (read the instructions carefully)

5. open up command prompt and change directory to the directory that your script is in. in windows this is the CD command, so if the script is in a folder called chillybot on your desktop on your C drive
it would look something like this (CD C:\Users\username\desktop\chillybot). this will vary depending on what your path is, to find out your exact path right click on the chillybot.js file and go to
properties. Location is your exact path, do not include the chillybot.js file in your CD command, it will not find it.

6. finally in order to run the bot after you have changed directory appropriately type (node chillybot.js) without the parenthesis into command prompt and hit enter. if it does not immediately give
you some kind of a runtime error it is working. login to your main turntable account and go to the room that you are running the bot in and see if it is there.

7. If everything has gone well, make your bot a moderator in the room so that it can effectively enforce it's commands.

*A last note, the auto djing in this script is meant for a 5 seater room, if you have less than five seats i highly recommend you turn this feature off when you start the bot up with the /getonstage command
If you cannot get this bot to run for some reason feel free to open an issue on github.

**A recent change has made it so that your bot will not be able to log in unless you verify it's email address first**

--------------------------------------------------------------------------------------
In order to find the userid, auth and roomid of your bot use this bookmark by alain gilbert.

http://alaingilbert.github.io/Turntable-API/bookmarklet.html
--------------------------------------------------------------------------------------