NadekoBot/docs/guides/Windows Guide.md

## Setting Up NadekoBot on Windows

#### Prerequisites 
- [Notepad++][Notepad++] (or some other decent text editor)
- Windows 8 or later

#### Guide 
- Download and run the [NadekoBot Updater][Updater]
- Press 'Install ffmpeg' button if you want music features 
*note: RESTART YOUR PC IF YOU DO*
- Press `Update` and go through the installation wizard
*note: If you're upgrading from 1.3, DO NOT select your old nadekobot folder. Install it in a separate directory and read the upgrading guide*
- When installation is finished, make sure 'open credentials.json' is checked. 
*note: Make sure to open it with Notepad++ or some other decent text editor.*

#### Creating DiscordBot application
- Go to [the Discord developer application page][DiscordApp].
- Log in with your Discord account.
- On the left side, press `New Application`.
- Fill out the `App Name` (your bot's name, in this case), put the image you want, and add an app description(optional).
- Create the application.
- Click on `Create a Bot User` and confirm that you do want to add a bot to this app.
- Keep this window open for now.
![img2](http://i.imgur.com/x3jWudH.gif)

#### Setting up credentials.json file
- In there you will see fields such as `Token`, `ClientId`, and `OwnerIDs`.
- In your [applications page][DiscordApp] (the window you were asked to keep open earlier), under the `Bot User` section, you will see `Token:click to reveal`, click to reveal the token. (Note: Make sure that you actually use a Token and not a Client Secret! It is in the **App Bot User** tab.)
- Copy your bot's token, and on the `"Token"` line of your `credentials.json`, paste your bot token **between** the quotation marks.
- Copy the `Client ID` on the page and replace the `12312123` part of the `ClientId` line with it.
- Go to a server on discord and attempt to mention yourself, but put a backslash at the start like shown below
- So the message `\@fearnlj01#3535` will appear as `<@145521851676884992>` after you send the message (to make it slightly easier, add the backslash after you type the mention out)
- The message will appear as a mention if done correctly, copy the numbers from the message you sent (`145521851676884992`) and replace the ID (By default, the ID is `105635576866156544`) on the `OwnerIds` section with your user ID shown earlier.
- Save `credentials.json`
- If done correctly, you are now the bot owner. You can add multiple owners by seperating each owner ID with a comma within the square brackets.
![img3](http://i.imgur.com/QwKMnTG.gif)

#### Inviting your bot to your server 
- [Invite Guide][Invite Guide]
- Copy your `Client ID` from your [applications page][DiscordApp].
- Replace the `12345678` in this link `https://discordapp.com/oauth2/authorize?client_id=12345678&scope=bot&permissions=66186303` with your `Client ID`.
- The link should now look like this: `https://discordapp.com/oauth2/authorize?client_id=**YOUR_CLENT_ID_HERE**&scope=bot&permissions=66186303`.
- Go to the newly created link and pick the server we created, and click `Authorize`.
- The bot should have been added to your server.
![img4](http://i.imgur.com/aFK7InR.gif)

#### Starting the bot
- Either press "Start" Button in the updater, or run the bot via it's desktop shortcut.

#### Updating NadekoBot
- Make sure the bot is closed and is not running (Run `.die` in a connected server to ensure it's not running).
- Open NadekoBot Updater
- If updates are available, you will be able to click on the Update button
- Start the bot
- You've updated and are running again, easy as that!

[Updater]: https://download.nadekobot.me/
[DiscordApp]: https://discordapp.com/developers/applications/me
[Notepad++]: https://notepad-plus-plus.org/
[Invite Guide]: http://discord.kongslien.net/guide.html
[Google Console]: https://console.developers.google.com
Update Windows Guide.md 2016-11-29 15:42:34 +00:00			`## Setting Up NadekoBot on Windows`

Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00			`#### Prerequisites`
More doc updates 2017-06-11 12:32:35 +00:00			`- [Notepad++][Notepad++] (or some other decent text editor)`
			`- Windows 8 or later`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00
o.o)/ 2017-04-19 06:09:08 +00:00			`#### Guide`
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			`- Download and run the [NadekoBot Updater][Updater]`
			`- Press 'Install ffmpeg' button if you want music features`
			`note: RESTART YOUR PC IF YOU DO`
			- Press `Update` and go through the installation wizard
			`note: If you're upgrading from 1.3, DO NOT select your old nadekobot folder. Install it in a separate directory and read the upgrading guide`
			`- When installation is finished, make sure 'open credentials.json' is checked.`
			`note: Make sure to open it with Notepad++ or some other decent text editor.`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00
o.o)/ 2017-04-19 06:09:08 +00:00			`#### Creating DiscordBot application`
Guides -> 1.0 It took so long after the last mention since I was too stubborn to just do this from a local git client for too long. Linux and OS X guides both have things built one by one for now and I'll only re-release the windows updater once I get the A-OK for not having to build things one by one. 2016-10-21 13:10:37 +00:00			`- Go to [the Discord developer application page][DiscordApp].`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00			`- Log in with your Discord account.`
			- On the left side, press `New Application`.
			- Fill out the `App Name` (your bot's name, in this case), put the image you want, and add an app description(optional).
			`- Create the application.`
Guides -> 1.0 It took so long after the last mention since I was too stubborn to just do this from a local git client for too long. Linux and OS X guides both have things built one by one for now and I'll only re-release the windows updater once I get the A-OK for not having to build things one by one. 2016-10-21 13:10:37 +00:00			- Click on `Create a Bot User` and confirm that you do want to add a bot to this app.
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00			`- Keep this window open for now.`
Added gifs Because why not? :3 2017-04-19 02:05:45 +00:00			`![img2](http://i.imgur.com/x3jWudH.gif)`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00
o.o)/ 2017-04-19 06:09:08 +00:00			`#### Setting up credentials.json file`
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			- In there you will see fields such as `Token`, `ClientId`, and `OwnerIDs`.
Updated windows guide doc 2017-05-03 20:47:12 +00:00			- In your [applications page][DiscordApp] (the window you were asked to keep open earlier), under the `Bot User` section, you will see `Token:click to reveal`, click to reveal the token. (Note: Make sure that you actually use a Token and not a Client Secret! It is in the App Bot User tab.)
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			- Copy your bot's token, and on the `"Token"` line of your `credentials.json`, paste your bot token between the quotation marks.
Guides -> 1.0 It took so long after the last mention since I was too stubborn to just do this from a local git client for too long. Linux and OS X guides both have things built one by one for now and I'll only re-release the windows updater once I get the A-OK for not having to build things one by one. 2016-10-21 13:10:37 +00:00			- Copy the `Client ID` on the page and replace the `12312123` part of the `ClientId` line with it.
Minor Guide Updates - Less saving of `credentials.json` required - Only needing to use `credentials_example.json` if you fuck up accounted for - Restore and build in one swift move accounted for 2016-10-22 08:05:42 +00:00			`- Go to a server on discord and attempt to mention yourself, but put a backslash at the start like shown below`
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			- So the message `\@fearnlj01#3535` will appear as `<@145521851676884992>` after you send the message (to make it slightly easier, add the backslash after you type the mention out)
A slight edit on replacing OwnerID A slight edit on replacing OwnerID If people asks about it, then it's not clear enough(?) lol http://i.imgur.com/WxZiu3G.png 2017-03-21 07:14:53 +00:00			- The message will appear as a mention if done correctly, copy the numbers from the message you sent (`145521851676884992`) and replace the ID (By default, the ID is `105635576866156544`) on the `OwnerIds` section with your user ID shown earlier.
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			- Save `credentials.json`
Minor Guide Updates - Less saving of `credentials.json` required - Only needing to use `credentials_example.json` if you fuck up accounted for - Restore and build in one swift move accounted for 2016-10-22 08:05:42 +00:00			`- If done correctly, you are now the bot owner. You can add multiple owners by seperating each owner ID with a comma within the square brackets.`
Added gifs Because why not? :3 2017-04-19 02:05:45 +00:00			`![img3](http://i.imgur.com/QwKMnTG.gif)`
Update ComprehensiveGuide.md 2016-04-16 04:15:25 +00:00
o.o)/ 2017-04-19 06:09:08 +00:00			`#### Inviting your bot to your server`
tests, docs from dev 2016-10-09 22:44:50 +00:00			`- [Invite Guide][Invite Guide]`
Guides -> 1.0 It took so long after the last mention since I was too stubborn to just do this from a local git client for too long. Linux and OS X guides both have things built one by one for now and I'll only re-release the windows updater once I get the A-OK for not having to build things one by one. 2016-10-21 13:10:37 +00:00			- Copy your `Client ID` from your [applications page][DiscordApp].
			- Replace the `12345678` in this link `https://discordapp.com/oauth2/authorize?client_id=12345678&scope=bot&permissions=66186303` with your `Client ID`.
Guide Housekeeping If I got the CarbonKey part wrong sue me, I'm going off what I saw in the commits and hoping it behaves as expected 2016-10-25 15:13:36 +00:00			- The link should now look like this: `https://discordapp.com/oauth2/authorize?client_id=YOUR_CLENT_ID_HERE&scope=bot&permissions=66186303`.
Guides -> 1.0 It took so long after the last mention since I was too stubborn to just do this from a local git client for too long. Linux and OS X guides both have things built one by one for now and I'll only re-release the windows updater once I get the A-OK for not having to build things one by one. 2016-10-21 13:10:37 +00:00			- Go to the newly created link and pick the server we created, and click `Authorize`.
Guide Housekeeping If I got the CarbonKey part wrong sue me, I'm going off what I saw in the commits and hoping it behaves as expected 2016-10-25 15:13:36 +00:00			`- The bot should have been added to your server.`
Added gifs Because why not? :3 2017-04-19 02:05:45 +00:00			`![img4](http://i.imgur.com/aFK7InR.gif)`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00
o.o)/ 2017-04-19 06:09:08 +00:00			`#### Starting the bot`
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			`- Either press "Start" Button in the updater, or run the bot via it's desktop shortcut.`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00
o.o)/ 2017-04-19 06:09:08 +00:00			`#### Updating NadekoBot`
Minor Guide Updates - Less saving of `credentials.json` required - Only needing to use `credentials_example.json` if you fuck up accounted for - Restore and build in one swift move accounted for 2016-10-22 08:05:42 +00:00			- Make sure the bot is closed and is not running (Run `.die` in a connected server to ensure it's not running).
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			`- Open NadekoBot Updater`
			`- If updates are available, you will be able to click on the Update button`
			`- Start the bot`
Goodbye sweet link to my Repo o7 README changed for the sake of it being easier to find and replace all links with `/1.0/` in them for when 1.0 eventually replaces the master branch 2016-10-24 21:27:14 +00:00			`- You've updated and are running again, easy as that!`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00
Updates links to docs, updated windows guide, added from source guide 2017-06-11 11:42:48 +00:00			`[Updater]: https://download.nadekobot.me/`
Update ComprehensiveGuide.md 2016-08-01 19:21:16 +00:00			`[DiscordApp]: https://discordapp.com/developers/applications/me`
			`[Notepad++]: https://notepad-plus-plus.org/`
			`[Invite Guide]: http://discord.kongslien.net/guide.html`
			`[Google Console]: https://console.developers.google.com`