Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/jsmnbom/vocabot

Vocaloid Bot for the Telegram Messenger
https://github.com/jsmnbom/vocabot

Last synced: about 22 hours ago
JSON representation

Vocaloid Bot for the Telegram Messenger

Awesome Lists containing this project

README

        

# VocaBot
Vocaloid Bot for the Telegram Messenger.

Search for songs, artists and even albums, all inside the telegram client. Can also display lyrics and PVs (videos).

Uses data from [VocaDB.net](http://vocadb.net) ([VocaDB/vocadb](https://github.com/VocaDB/vocadb)). Click [here](http://wiki.vocadb.net/wiki/29/license) for licensing information.

## How to use
### Easy method
Use from telegram via [@VocaDBBot](https://telegram.me/VocaDBBot) (temporary name).

### Set up yourself
You can also run the bot yourself by following these steps:

1. Install python 3, clone repository and install requirements via pip
2. Ask [@botfather](https://telegram.me/botfather) for a bot token and put it in `VOCABOT_TOKEN` environment variable. You might also want to change `OWNER_IDS` inside [VocaBot/constants.py](VocaBot/constants.py) (if you don't want me to be able to kill your bot that is).
3. Run `$ python3 main.py`

# Thanks to
* [VocaDB.net](http://vocadb.net) ([VocaDB/vocadb](https://github.com/VocaDB/vocadb)) and all the amazing editors on there
* [@Cawthorned](https://github.com/Cawthorned) for translations/personality modules (not currently implemented) and profile picture
* and let's not forget [python-telegram-bot](https://github.com/python-telegram-bot/python-telegram-bot)