Updated Linux usage instructions (markdown)

Alexey Golub
2018-09-12 21:48:31 +03:00
parent 32eb93de67
commit f4affb71a2

@@ -1,27 +1,46 @@
Credits to [@RenanYudi](https://github.com/RenanYudi). For more info check out the discussion [here](https://github.com/Tyrrrz/DiscordChatExporter/issues/75).
The GUI version doesn't work on non-Windows OS.
You can use DiscordChatExporter with CLI and Mono. It isn't that user friendly, but it works.
# Manual Install
## Installing Mono
### Debian 9
---
**Installing Mono**
To get mono on Ubuntu/Debian ([other distros and more info here](https://www.mono-project.com/download/stable/#download-lin-ubuntu)):
Open Terminal and type
1. `sudo apt-get install mono-devel`
1. `su`
2. `apt install apt-transport-https dirmngr`
3. `apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF`
4. `echo "deb https://download.mono-project.com/repo/debian stable-stretch main" | tee /etc/apt/sources.list.d/mono-official-stable.list`
5. `apt update`
6. `apt install mono-devel`
You can check if mono was installed successfully using `mono -V`, it should output its version. If it didn't work, try the link above for more info.
### Ubuntu 18
---
1. `sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF`
2. `echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list`
3. `sudo apt update`
4. `sudo apt install mono-devel`
**Downloading and using DiscordChatExporter**
##
Check if mono was installed using `mono -V`. If it didn't work, try [this link](https://www.mono-project.com/download/stable).
1. Download the latest DiscordChatExporter CLI release [here](https://github.com/Tyrrrz/DiscordChatExporter/releases/latest) and extract its contents on your Desktop to a folder called `DiscordChatExporter`.
2. Open terminal and type to change Terminal directory:
`cd ~/Desktop/DiscordChatExporter`
3. Replace `TOKEN` and `CHANNEL`, and execute the command to run DiscordChatExporter.Cli.exe:
## Downloading and using DiscordChatExporter.Cli.exe
Download the latest DiscordChatExporter.CLI.zip [here](https://github.com/Tyrrrz/DiscordChatExporter/releases/latest) and move it to your Desktop. In Terminal type:
1. `cd ~/Desktop`
2. `unzip DiscordChatExporter.CLI.zip -d /DiscordChatExporter | cd DiscordChatExporter`
3. Replace `TOKEN` and `CHANNEL`, and execute this command to run DiscordChatExporter.Cli.exe
`mono DiscordChatExporter.Cli.exe -t TOKEN -c CHANNEL`
---
It's also possible to run the CLI on macOS, but installing mono is a little bit different, since you'd be using brew or macports instead of apt.
The GUI version doesn't work on non-Windows OS.
# Automatic Install
**First run only**
Download the latest maclinux.command and DiscordChatExporter [here], and move it inside a folder. In Terminal:
1. `cd` to its Directory
2. Run `chmod +x maclinux.command` as root
3. Run `./maclinux.command` as root
4. Choose options [5] and [6]
##
When the dependencies have been installed, to use the tool again just:
1. `cd` to its Directory
2. Run `./maclinux.command`
##
Credits to [@RenanYudi](https://github.com/RenanYudi)