# DiscordChatExporter
[](https://tyrrrz.me/ukraine)
[](https://github.com/Tyrrrz/DiscordChatExporter/actions)
[](https://codecov.io/gh/Tyrrrz/DiscordChatExporter)
[](https://github.com/Tyrrrz/DiscordChatExporter/releases)
[](https://github.com/Tyrrrz/DiscordChatExporter/releases)
[](https://discord.gg/2SUWKFnHSm)
[](https://tyrrrz.me/donate)
[](https://twitter.com/tyrrrz/status/1495972128977571848)
> 🟡 **Project status**: maintenance mode<sup>[[?]](https://github.com/Tyrrrz/.github/blob/master/docs/project-status.md)</sup>
**DiscordChatExporter** is an application that can be used to export message history from any [Discord ](https://discord.com ) channel to a file.
It works with direct messages, group messages, and server channels, and supports Discord's dialect of markdown as well as most other rich media features.
> ❔ If you have questions or issues, **please refer to the [docs](.docs)**.
> 💬 If you want to chat, **join my [Discord server](https://discord.gg/2SUWKFnHSm)**.
## Terms of use<sup>[[?]](https://github.com/Tyrrrz/.github/blob/master/docs/why-so-political.md)</sup>
By using this project or its source code, for any purpose and in any shape or form, you grant your **implicit agreement** to all the following statements:
- You **condemn Russia and its military aggression against Ukraine**
- You **recognize that Russia is an occupant that unlawfully invaded a sovereign state**
- You **support Ukraine's territorial integrity, including its claims over temporarily occupied territories of Crimea and Donbas**
- You **reject false narratives perpetuated by Russian state propaganda**
To learn more about the war and how you can help, [click here ](https://tyrrrz.me/ukraine ). Glory to Ukraine! 🇺🇦
## Download
This application comes in two flavors: graphical user interface (**GUI**) and command-line interface (**CLI**).
The following table lists all available download options:
< table >
< thead >
< tr >
< th > < / th >
< th > Downloads< / th >
< th > Supported OS< / th >
< / tr >
< / thead >
< tbody >
< tr >
< td > < b > GUI< / b > < / td >
< td >
< ul >
< li > 🟢 < b > < a href = "https://github.com/Tyrrrz/DiscordChatExporter/releases/latest" > Stable release< / a > < / b > (< code > DiscordChatExporter.zip< / code > )< / li >
< li > 🟠 < a href = "https://github.com/Tyrrrz/DiscordChatExporter/actions/workflows/main.yml" > CI build< / a > (< code > DiscordChatExporter.zip< / code > )< / li >
< / ul >
< / td >
< td >
< ul >
< li > Windows < b > 7< / b > or higher< / li >
< / ul >
< / td >
< / tr >
< tr >
< td > < b > CLI< / b > < / td >
< td >
< ul >
< li > 🟢 < b > < a href = "https://github.com/Tyrrrz/DiscordChatExporter/releases/latest" > Stable release< / a > < / b > (< code > DiscordChatExporter.CLI.zip< / code > < / li >
< li > 🟠 < a href = "https://github.com/Tyrrrz/DiscordChatExporter/actions/workflows/main.yml" > CI build< / a > (< code > DiscordChatExporter.CLI.zip< / code > )< / li >
< li > 🐋 < a href = "https://hub.docker.com/r/tyrrrz/discordchatexporter" > Docker< / a > (< code > tyrrrz/discordchatexporter< / code > )< / li >
< li > 📦 < a href = "https://aur.archlinux.org/packages/discord-chat-exporter-cli" > AUR< / a > (< code > discord-chat-exporter-cli< / code > )< / li >
< li > 📦 < a href = "https://search.nixos.org/packages?query=discordchatexporter-cli" > Nix< / a > (< code > discordchatexporter-cli< / code > )< / li >
< / ul >
< / td >
< td >
< ul >
< li > Windows < b > 7< / b > or higher< / li >
< li > macOS < b > 10.13 (High Sierra)< / b > or higher< / li >
< li > Linux (multiple distros)< / li >
< / ul >
< / td >
< / tr >
< / tbody >
< / table >
> **Note**:
> AUR and Nix packages linked above are maintained by the community.
> If you have any issues with them, please contact the corresponding maintainers.
> **Warning**:
> To run **DiscordChatExporter** on macOS and Linux, you need to make sure that **.NET 7.0 Runtime** is installed.
> You can download it here:
>
> - [.NET 7.0 Runtime for **macOS x64**](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-7.0.101-macos-x64-installer)
> - [.NET 7.0 Runtime for **macOS Arm64**](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-7.0.101-macos-arm64-installer)
> - [.NET 7.0 Runtime for **Linux**](https://docs.microsoft.com/en-us/dotnet/core/install/linux) (find the correct download for your distro)
>
> This should not be necessary if you install **DiscordChatExporter** using a package manager, as it should take care of the dependencies for you.
> This is also not necessary if you are running **DiscordChatExporter** via Docker, because the image already contains the runtime.
## Features
- Graphical user interface (Windows)
- Command-line interface (Windows, Linux, macOS)
- Authentication via both user and bot tokens
- Multiple output formats: HTML (dark/light), TXT, CSV, JSON
- Support for markdown, attachments, embeds, emoji, and other rich media features
- File partitioning, date ranges, message filtering, and other export options
- Self-contained exports that don't require internet
## Screenshots
## Related projects
- [**Chat Analytics** ](https://github.com/mlomb/chat-analytics ) — solution for analyzing chat patterns of Discord users, using exports produced by **DiscordChatExporter** .
- [**DiscordChatExporter-frontend** ](https://github.com/slatinsky/DiscordChatExporter-frontend ) — convenient viewer for exports produced by **DiscordChatExporter** .
