Skip to content

Latest commit

 

History

History
45 lines (31 loc) · 3.08 KB

README.md

File metadata and controls

45 lines (31 loc) · 3.08 KB
Raw

Naoko - A Synchtube bot

Continued at https://github.com/Suwako/cyNaoko for Cytube

Requirements

  • Naoko was developed using Python 2.7.2
  • Naoko requires a registered Synchtube account, and most functionality does not work properly without being a moderator.
  • Due to a bug in OpenSSL 1.0.1 and its interface with Python 2.7.2 some functionality on Linux requires curl to be installed. Without curl installed Naoko will be unable to verify Dailymotion videos or properly handle removed videos or videos with embedding disabled. She will wait DEFAULT_WAIT, which is set to 3 hours, if a leader changes to a Dailymotion video bypassing the playlist, so curl is strongly recommended. This bug does not affect Windows users and they will not need to install any additional programs.
  • Running the web server with the fastcgi protocol requires that flup be installed. It can be installed using pip flup or easy_install flup

Usage

  git clone git://github.com/Suwako/Naoko.git
  cd Naoko
  python naoko/main.py

Edit the included naoko.conf file to control the settings. By default the bot will join room "Science" with the nick "DenshiBot"

Web Server Usage

By default the web server is disabled. Configure the web server in naoko.conf The webserver can be run in two modes: standalone, in which the web server is run as a separate daemon process, and embedded, in which the web server runs as part of Naoko. Currently standalone mode only works on operating systems that supply a proper fork(), which does not include Windows.

To control standalone mode use:

    python naoko/webserver.py start|stop|restart|status

The web server can be run either as an http server using the bottle.py development server, which is slow but straightforward, or as a fastcgi server using flup. The fastcgi server only works in standalone mode.

History by Falaina

This is just a small explanation on how this code relates to the bot that used to be in the synchtube animu room.

I used to run a bot named "Denshi" in the animu synchtube room. Denshi was written in node.js and was written while I was learning the synchtube protocol. As a result Denshi's source is, in all honesty, a complete mess. I used random node.js modules to do silly things and hardcoded paths and values. I probably will not release that source code as it's so shoddy I don't want my named attached to it; additionally it'd be relatively hard to get working on any machine that wasn't her original VPS.

The code in this repository was the beginning of my attempt to rewrite Denshi in Python with minimal use of external libraries so it could be more easily used by others. I didn't get much farther than having it connect and print information. I've decided to release it as it should allow anyone with some knowledge of Python to program a working bot without worrying too much about the socket-level details. In its current state it isn't very useful though.

I encourage anyone to fork this and make a more useful base bot for other channels to use, as I don't have the time to do much other than small bug fixes on this base.