Metadata-Version: 2.0
Name: discord-musicbot
Version: 0.0.2.dev20170604
Summary: MusicBot bot for Discord.
Home-page: https://github.com/andasilva/MusicBot
Author: Quentin Vaucher de la Croix & Neto da Silva André
Author-email: quentin.vaucher@he-arc.ch & andre.netodasilva@he-arc.ch
License: https://opensource.org/licenses/BSD-3-Clause
Keywords: discord asyncio bot
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.6
Requires-Dist: aiohttp (>=2.1.0)
Requires-Dist: selenium (==3.4.3)
Requires-Dist: spotipy (>=2.4.4)
Provides-Extra: docs
Requires-Dist: Sphinx (>=1.6.0); extra == 'docs'
Requires-Dist: sphinxcontrib-trio; extra == 'docs'
Provides-Extra: fast
Requires-Dist: aiodns; extra == 'fast'
Requires-Dist: cchardet; extra == 'fast'
Provides-Extra: qa
Requires-Dist: flake8; extra == 'qa'
Requires-Dist: isort; extra == 'qa'
Requires-Dist: pycodestyle; extra == 'qa'
Requires-Dist: pydocstyle; extra == 'qa'
Requires-Dist: rstcheck; extra == 'qa'

========
MusicBot
========

.. image:: https://travis-ci.org/andasilva/MusicBot.svg?branch=master
   :target: https://travis-ci.org/andasilva/MusicBot
   :alt: Build Status

.. image:: https://img.shields.io/github/stars/andasilva/musicbot.svg
  :target: https://github.com/andasilva/musicbot/stargazers
  :alt: GitHub Stars

.. image:: https://readthedocs.org/projects/musicbot/badge/?version=latest
   :target: http://musicbot.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status


Discord bot made with Python which is aimed to control Spotify.

Getting started
================

Explanations for setting up and running the bot.

Requirements
------------

- `Python 3.6 <https://www.python.org/>`_
- `aiohttp 2.1.0 <https://pypi.python.org/pypi/aiohttp>`_
- `Selenium-Python <https://selenium-python.readthedocs.io/>`_
- `Spotipy <https://spotipy.readthedocs.io/en/latest/>`_

Installation
------------

.. code-block:: console

    $ pip install musicbot

Running
-------

.. code-block:: console

    $ python -m musicbot

If you entered wrong user credentials, you can restart
the configuration as follows:

.. code-block:: console

    $ python -m musicbot reset

Configuration
-------------

At the first start of the bot, some configurations questions
are asked to the user from command line. These are the following:

- Channel ID of the bot
- Discord token
- Spotify token
- Spotify Client ID/Secret

Once they're configured, there's no need to configure them again.

webdriver
---------

The bot may use a chrome webdriver in order to manage the Spotify app by itself.
The driver can be found here: `Chrome webdriver <https://sites.google.com/a/chromium.org/chromedriver/downloads>`_

Note that the driver must be in the user's PATH.

Bibliography
============

- `A Discord bot with asyncio <https://tutorials.botsfloor.com/a-discord-bot-with-asyncio-359a2c99e256>`_
- `Discord API Reference <https://discordapp.com/developers/docs/reference>`_
- `Spotify API Reference <https://developer.spotify.com/web-api>`_
- `Travisbot <https://github.com/greut/travisbot>`_


