## [Documentation](https://dtbot.realpha.ru/)

## Bot's features

* Shows weather
* Translate words
* Shows news
* Shows and converts currency
* Makes polls
* Plays music from Youtube
* Plays music from online radio stations
* Announcing if Twitch stream is started
* Greetings new users

## How to use

Bot commands

To use the `!b` commands you need to be a server admin or have role named `bot.admin`!

## Help command
Command | Description
------- | -----------
`!help` | Shows help
`!help [command]` | Detail help `!help y`
`!help bot.admin` | Shows help how get `bot.admin` role

## Config command
Command | Description
------- | -----------
`!b clear [from_num]` | Remove bot's messages `!b clear` or `!b clear 3` removes all messages from 3rd message
`!b setconf [parameter] [value]` | Sets the bot configuration for your channel.

## Voice command
Command | Description
------- | -----------
`!v join` | Add bot into you voice channel
`!v leave` | Remove bot from voice channel

## Youtube player command
Command | Description
------- | -----------
`!play [youtube_url]` | Adds the track (or playlist) in a queue and start playing. For this command you don't need to use `!v join`, it happens automatically.
`!y add [song]` | Adds song from youtube
`!y clear` | Removes all songs from queue
`!y play` | Starts playing queue
`!y stop` | Stops playing queue
`!y skip` | Skipping one song
`!y list` | List of songs in queue

## Radio command
Command | Description
------- | -----------
`!r play [radio_station]` | Plays specified network radio station `!r play http://air2.radiorecord.ru:9003/rr_320`
`!r stop` | Stops radio
`!r list` | List of radiostations
`!r station [station_code]` | Listen to the specified radio station

## Weather command
Command | Description
------- | -----------
`!w [place]` | Shows the weather in a specified location `!w New York`

## News command
Command | Description
------- | -----------
`!n [category]` | Displays news in the specified category `!n technology`

## Translate command
Command | Description
------- | -----------
`!t [target_lang] [text]` | Translator `!t ru Hello world`. All available languages can be seen in the documentation.

## Currency command
Command | Description
------- | -----------
`!c` | Shows currencies (default from config)
`!c list` | Shows list of available currencies
`!c [currency]` | Shows specified currency `!c USD EUR`
`!c conv [from][to][quantity]` | Converts one currency to another `!c conv USD EUR 10`

## Poll command
Command | Description
------- | -----------
`!p new [fields]` | Creates new poll `!p new field one \| field two \| field three`
`!p vote [field_num]` | Votes in poll
`!p end` | Ends poll and shows results

## Map command
Command | Description
------- | -----------
`!m [map/sat] [location]` | Sends location image from yandex map `!m map New-York` or `!m sat New-York`

## GeoIP command
Command | Description
------- | -----------
`!geoip [some_ip_address]` | Shows geographic information about IP

## Twitch command
Command | Description
------- | -----------
`!twitch add [twitch_login]  [custom_announce_message]` | Adds streamer in announcer (custom message is optional)
`!twitch remove [twitch_login]` | Removes streamer from announcer

## Greetings command
Command | Description
------- | -----------
`!greetings add [text]` | Adds new greetings message with specified text
`!greetings remove` | Removes greetings message
`!greetings test` | Sends you a greetings message

## Set config parameters

Parameter | Description
--------- | -----------
`general.language [string]` | Sets bot language
`general.timezone [num]` | Sets bot timezone
`general.nick [string]` | Sets bot nickname
`embed.color [hex color like #007700]` | Sets bot embed color
`news.country [string]` | Sets bot news country
`weather.city [string]` | Sets default city for weather

Musor

YouTube, Radio, Twitch, Translate, Weather, Polls, Currency convertor and other useful features!

Voting for Musor

Do you want to support us?