diff --git a/Linux-usage-instructions.md b/Linux-usage-instructions.md index 3554ccc..5542496 100644 --- a/Linux-usage-instructions.md +++ b/Linux-usage-instructions.md @@ -2,33 +2,15 @@ ## Manual Installation ### Installing Mono -### Debian 9 +Please follow the [instructions provided here](https://www.mono-project.com/download/stable/) - $ su - # apt install apt-transport-https dirmngr - # apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF - # echo "deb https://download.mono-project.com/repo/debian stable-stretch main" | tee /etc/apt/sources.list.d/mono-official-stable.list - # apt update - # apt install mono-devel - -### Ubuntu 18 - - $ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF - $ echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list - $ sudo apt update - $ sudo apt install mono-devel - - -[**Other versions**](https://www.mono-project.com/download/stable) -## - -### Downloading and using DiscordChatExporter.Cli.exe -Download and unzip the [latest CLI version](https://github.com/Tyrrrz/DiscordChatExporter/releases/latest) to a folder. - -Replace `TOKEN` and `CHANNEL`, then execute this command to export: - - mono DiscordChatExporter.Cli.exe export -t TOKEN -c CHANNEL +### Running the exporter +Download and extract the [latest CLI release](https://github.com/Tyrrrz/DiscordChatExporter/releases/latest). +Replace `TOKEN` and `CHANNEL`, then run this command to export: +``` +mono DiscordChatExporter.Cli.exe export -t TOKEN -c CHANNEL +``` ## Automatic Installation **First run** @@ -41,45 +23,52 @@ Download and unzip the [latest tool](https://github.com/RenanYudi/DiscordChatExp To use the tool again just: 1. `cd` to its directory 2. Run `./maclinux.command` -## -Special thanks to [@RenanYudi](https://github.com/RenanYudi) # GUI +The GUI version of DiscordChatExporter runs well on Wine, with the exception of some cosmetic issues (e.g. black lines sporadically appearing across the application or icons being cut off). However, some additional steps are necessary for the installation. -The GUI version of DiscordChatExporter runs on well on wine, with the exception of some cosmetic issues (e.g. black lines sporadically appearing across the application or icons being cut off.) However, some workarounds are necessary for the installation. - -### Installing wine-staging -Follow the instructions on the page corresponding to your distribution for the wine-staging package. - -Ubuntu: https://wiki.winehq.org/Ubuntu - -Debian: https://wiki.winehq.org/Debian - -Pages for other distributions can be found here: https://wiki.winehq.org/Download +### Installing winehq-stable +Follow the instructions on the page corresponding to your distribution for the `winehq-stable` package [here](https://wiki.winehq.org/Download). ### Installing winetricks and .NET 4.6 +Debian and Ubuntu: + +``` +$ sudo apt install -y binutils cabextract p7zip zenity unzip wget p11-kit-modules:i386 +``` + Download winetricks via: ``` -$ cd "${HOME}/Downloads" -$ wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks +$ cd ~/Downloads +$ wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks $ chmod +x winetricks ``` -Then, run the following commands to install .NET 4.6 for wine: +Then, run the following commands to install .NET for Wine: + ``` -$ sudo apt-get install binutils cabextract p7zip zenity unrar unzip wget p11-kit-modules:i386 libp11-kit-gnome-keyring:i386 $ env WINEPREFIX="$HOME/wine" WINEARCH=win32 wine wineboot $ env WINEPREFIX="$HOME/wine" WINEARCH=win32 ./winetricks dotnet46 ``` -You will have to go through several installer prompts during the installation process; go through them as you would normally and don't close the console until its output is finished. +There'll be several installer prompts, go through them as you normally would and do NOT close the Terminal window until its output is finished. ### Running the exporter -Download and extract the latest release of the [GUI exporter here.](https://github.com/Tyrrrz/DiscordChatExporter/releases/latest) +Download and extract the [latest DiscordChatExporter.zip](https://github.com/Tyrrrz/DiscordChatExporter/releases/latest). Then, in the extracted folder, run this command to start the exporter: -`$ env WINEPREFIX="$HOME/wine" WINEARCH=win32 wine DiscordChatExporter.exe` - -Alternatively, you may set globally set the WINEPREFIX and WINEARCH environment variables to those of the above and simply run `wine DiscordChatExporter.exe`. \ No newline at end of file +``` +$ env WINEPREFIX="$HOME/wine" WINEARCH=win32 wine DiscordChatExporter.exe +``` +**Alternatively**, you may globally set the WINEPREFIX and WINEARCH environment variables with: +``` +$ export WINEPREFIX="$HOME/wine" && export WINEARCH=win32 +``` + So the tool can be started with a simple command: +``` +$ wine DiscordChatExporter.exe +``` +## +Special thanks to [@RenanYudi](https://github.com/RenanYudi) and [@jman005](https://github.com/jman005) (GUI on Wine) \ No newline at end of file