DiscordChatExporter

DiscordChatExporter is used to export message history from Discord channels (Direct Messages, Group Messages, and Server Channels) to local files.

Key Capabilities

• Authentication: Supports both user tokens and bot tokens.
• Output Formats: Export to HTML (with dark/light themes), TXT, CSV, or JSON.
• Rich Media Support: Preserves Discord's markdown dialect, attachments, embeds, and emojis.
• Advanced Filtering: Supports file partitioning, specific date ranges, and message filtering.
• Offline Viewing: Produces self-contained exports that can be viewed without an internet connection.

WARNING

Automating user accounts is against Discord's Terms of Service and may result in account bans. It is recommended to use a bot for exporting logs from accessible channels whenever possible.

The Command-Line Interface (CLI) version is a terminal application suitable for automation and scripting.

Package Managers

• Docker: docker pull tyrrrz/discordchatexporter
• WinGet: winget install Tyrrrz.DiscordChatExporter.CLI
• AUR (Arch Linux): yay -S discord-chat-exporter-cli
• Nix: nix-shell -p discordchatexporter-cli

Manual Download

Download the DiscordChatExporter.Cli.*.zip file from the latest stable releases.

# Example: Pulling the Docker image
docker pull tyrrrz/discordchatexporter

# Example: Installing via WinGet
winget install Tyrrrz.DiscordChatExporter.CLI

To run the test suite locally, you must join the dedicated test Discord server and provide a valid Discord authentication token via user secrets. This allows the tests to interact with a real Discord environment designed to exercise specific behaviors.

1. Join the test server: https://discord.gg/eRV8Vap5bm
2. Obtain your Discord authentication token.
3. Store your token in your local user secrets using the DISCORD_TOKEN key.
4. Execute the tests using the dotnet CLI.

# Set your authentication token
dotnet user-secrets set DISCORD_TOKEN <token>

# Run the tests
dotnet test

To identify which server or channel to export, you must enable Developer Mode in Discord:

1. Open Discord.
2. Open Settings.
3. Go to the Advanced section.
4. Enable Developer Mode.
5. Right-click on the desired server or channel and click Copy Server ID or Copy Channel ID.

If you are using a bot, you need the token generated during the bot's creation. If you have lost it, you can reset it via the Discord Developer Portal:

1. Go to the Discord developer portal.
2. Open your application's settings.
3. Navigate to the Bot section on the left.
4. Under Token, click Reset Token.
5. Click Yes, do it! and authenticate to confirm.

Note:

• Integrations using the previous token will stop working until updated.
• Your bot must have the Message Content Intent enabled in the developer portal to read messages.

To use DiscordChatExporter with a personal account, you need your authorization token.

Warning: Automating user accounts is technically against Discord's Terms of Service. Use at your own risk.

1. Open Discord in your web browser and login.
2. Open any server or direct message channel.
3. Press Ctrl+Shift+I to show developer tools.
4. Navigate to the Network tab.
5. Press Ctrl+R to reload.
6. Switch between random channels to trigger network requests.
7. Search for a request that starts with "messages".
8. Select the Headers tab on the right.
9. Scroll down to the Request Headers section.
10. Copy the value of the "authorization" header.

The following options are available for the exportall command to filter content or specify the data source.

--include-dm             Include direct message channels. (Default: true)
--include-guilds         Include server channels. (Default: true)
--include-vc             Include voice channels. (Default: true)
--data-package <path>    Path to the personal data package (ZIP file) requested from Discord. If provided, only channels referenced in the dump will be exported.

When exporting chats, you can specify how threads (such as forum posts or specific thread types) are included in the export using the ThreadInclusionMode option. This determines whether the exporter ignores threads, only includes active ones, or includes all available threads.

ThreadInclusionMode:
- None: No threads are included in the export.
- Active: Only active threads are included.
- All: All threads are included in the export.

The export command uses the following option to identify targets:

--channel <CHANNEL_ID>
-c <CHANNEL_ID>

The following options are available for the channels command:

--guild <GUILD_ID>
--include-vc
--include-threads <MODE>

The following options are available for the exportguild command:

--guild, -g <Snowflake>
--include-vc