![](\"https://i.imgur.com/PbUyRXD.png\")
\n\nThe Plain Text format formats messages as plain text, and has the smallest size.\nYou can open `.txt` files with a text editor, such as Notepad.\n\n### JSON\n\n![](\"https://i.imgur.com/FAeSA4O.png\")
\n\nThe JSON format contains more technical information and is easily parsable.\nYou can open `.json` files with a text editor, such as Notepad.\n\n### CSV\n\n\n\n\nThe CSV format allows for easy parsing of the chat log. Depending on your needs, the JSON format might be better.\nYou can open `.csv` files with a text editor, such as Notepad, or a spreadsheet app, like Microsoft Excel and Google Sheets.\n"
},
{
"path": ".docs/Message-filters.md",
"content": "# Message filters\n\nYou can use a special notation to filter messages that you want to have included in an export. The notation syntax is designed to mimic Discord's search query syntax, but with additional capabilities.\n\nTo configure a filter, specify it in advanced export parameters when using the GUI or by passing the `--filter` option when using the CLI. For the CLI version, see also [caveats](#cli-caveats).\n\n## Examples\n\n- Filter by user\n\n```console\nfrom:Tyrrrz\n```\n\n- Filter by user (with discriminator)\n\n```console\nfrom:Tyrrrz#1234\n```\n\n- Filter by message content (allowed values: `link`, `embed`, `file`, `video`, `image`, `sound`)\n\n```console\nhas:image\n```\n\n- Filter by mentioned user (same rules apply as with `from:` filter)\n\n```console\nmentions:Tyrrrz#1234\n```\n\n- Filter by contained text (has word \"hello\" and word \"world\" somewhere in the message text):\n\n```console\nhello world\n```\n\n- Filter by contained text (has the string \"hello world\" somewhere in the message text):\n\n```console\n\"hello world\"\n```\n\n- Combine multiple filters ('and'):\n\n```console\nfrom:Tyrrrz has:image\n```\n\n- Same thing but with an explicit operator:\n\n```console\nfrom:Tyrrrz & has:image\n```\n\n- Combine multiple filters ('or'):\n\n```console\nfrom:Tyrrrz | from:\"96-LB\"\n```\n\n- Combine multiple filters using groups:\n\n```console\n(from:Tyrrrz | from:\"96-LB\") has:image\n```\n\n- Negate a filter:\n\n```console\n-from:Tyrrrz | -has:image\n```\n\n- Negate a grouped filter:\n\n```console\n-(from:Tyrrrz has:image)\n```\n\n- Escape special characters (`-` is escaped below, so it's not parsed as negation operator):\n\n```console\nfrom:96\\-LB\n```\n\n## CLI Caveats\n\nIn most cases, you will need to enclose your filter in quotes (`\"`) to escape characters that may have special meaning in your shell:\n\n```console\n$ ./DiscordChatExporter.Cli export [...] --filter \"from:Tyrrrz has:image\"\n```\n\nIf you need to include quotes inside the filter itself as well, use single quotes (`'`) for those instead:\n\n```console\n$ ./DiscordChatExporter.Cli export [...] --filter \"from:Tyrrrz 'hello world'\"\n```\n\nAdditionally, negated filters (those that start with `-`) may cause parsing issues even when enclosed in quotes. To avoid this, use the tilde (`~`) character instead of the dash (`-`):\n\n```console\n$ ./DiscordChatExporter.Cli export [...] --filter ~from:Tyrrrz\n```\n"
},
{
"path": ".docs/Readme.md",
"content": "# Home\n\n## Installation & Usage\n\n- Getting started:\n - [Using the GUI](Using-the-GUI.md)\n - [Using the CLI](Using-the-CLI.md)\n - [File formats](Getting-started.md#file-formats)\n\n## Guides\n\n- [How to get Token and Channel IDs](Token-and-IDs.md)\n- [How to use message filters](Message-filters.md)\n- Export scheduling with CLI:\n - [Windows](Scheduling-Windows.md)\n - [macOS](Scheduling-MacOS.md)\n - [Linux](Scheduling-Linux.md)\n\n## Video tutorial\n\n- Video by [NoIntro Tutorials](https://youtube.com/channel/UCFezKSxdNKJe77-hYiuXu3Q) (using DiscordChatExporter GUI)\n\n[](https://youtube.com/watch?v=jjtu0VQXV7I)\n\n## FAQ & Troubleshooting\n\n- [General questions](Troubleshooting.md#general)\n- [First steps help](Troubleshooting.md#first-steps)\n- [It's crashing/failing](Troubleshooting.md#DCE-is-crashingfailing)\n- [Errors](Troubleshooting.md#errors)\n- [**More help**](Troubleshooting.md)\n"
},
{
"path": ".docs/Scheduling-Linux.md",
"content": "# Scheduling exports with Cron\n\n## Creating the script\n\n1. Open Terminal and create a new text file with `nano /path/to/DiscordChatExporter/cron.sh`\n\n> **Note**:\n> You can't use your mouse in nano, use the arrow keys to control the cursor (caret).\n\n2. Paste the following into the text file:\n\n```bash\n#!/bin/bash\n# Info: https://github.com/Tyrrrz/DiscordChatExporter/blob/prime/.docs\n\nTOKEN=tokenhere\nCHANNELID=channelhere\nDLLFOLDER=dceFOLDERpathhere\nFILENAME=filenamehere\nEXPORTDIRECTORY=dirhere\nEXPORTFORMAT=formathere\n# Available export formats: plaintext, htmldark, htmllight, json, csv\n# /\\ CaSe-SeNsItIvE /\\\n# You can edit the export command on line 40 if you'd like to include more options like date ranges and date format. You can't use partitioning (-p) with this script.\n\n# This will verify if EXPORTFORMAT is valid and will set the final file extension according to it. If the format is invalid, the script will display a message and exit.\nif [[ \"$EXPORTFORMAT\" == \"plaintext\" ]]; then\nFORMATEXT=.txt\nelif [[ \"$EXPORTFORMAT\" == \"htmldark\" ]] || [[ \"$EXPORTFORMAT\" == \"htmllight\" ]]; then\nFORMATEXT=.html\nelif [[ \"$EXPORTFORMAT\" == \"json\" ]]; then\nFORMATEXT=.json\nelif [[ \"$EXPORTFORMAT\" == \"csv\" ]]; then\nFORMATEXT=.csv\nelse\necho \"$EXPORTFORMAT - Unknown export format\"\necho \"Available export formats: plaintext, htmldark, htmllight, csv, json\"\necho \"/\\ CaSe-SeNsItIvE /\\\\\"\nexit 1\nfi\n\n# This will change the script's directory to DLLPATH, if unable to do so, the script will exit.\ncd $DLLFOLDER || exit 1\n\n# This will export your chat\n./DiscordChatExporter.Cli export -t $TOKEN -c $CHANNELID -f $EXPORTFORMAT -o $FILENAME.tmp\n\n# This sets the current time to a variable\nCURRENTTIME=$(date +\"%Y-%m-%d-%H-%M-%S\")\n\n# This will move the .tmp file to the desired export location, if unable to do so, it will attempt to delete the .tmp file.\nif ! mv \"$FILENAME.tmp\" \"${EXPORTDIRECTORY//\\\"}/$FILENAME-$CURRENTTIME$FORMATEXT\" ; then\necho \"Unable to move $FILENAME.tmp to $EXPORTDIRECTORY/$FILENAME-$CURRENTTIME$FORMATEXT.\"\necho \"Cleaning up...\"\n if ! rm -Rf \"$FILENAME.tmp\" ; then\n echo \"Unable to remove $FILENAME.tmp.\"\n fi\nexit 1\nfi\nexit 0\n```\n\n3. Replace:\n\n- `tokenhere` with your [Token](Token-and-IDs.md).\n- `channelhere` with a [Channel ID](Token-and-IDs.md).\n- `dceFOLDERpathhere` with DCE's **directory path** (e.g. `/path/to/folder`, NOT `/path/to/folder/DiscordChatExporter.dll`).\n- `filenamehere` with the exported channel's filename, without spaces.\n- `dirhere` with the export directory (e.g. /home/user/Documents/Discord\\ Exports).\n- `formathere` with one of the available export formats.\n\n> **Note**:\n> Remember to escape spaces (add `\\` before them) or to quote (\") the paths (`\"/home/my user\"`)!\n\n> **Note**:\n> To save, hold down CTRL and then press O, if asked for a filename, type it and press ENTER. Hit CTRL+X to exit the text editor.\n> [Check out this page](https://wiki.gentoo.org/wiki/Nano/Basics_Guide) if you want to know more about nano.\n\n4. Make your script executable with `chmod +x /path/to/DiscordChatExporter/cron.sh`\n\n5. Let's edit the cron file. If you want to run the script with your user privileges, edit it by running `crontab -e`. If you want to run the script as root, edit it with `sudo crontab -e`. If this is your first time running this command, you might be asked to select a text editor. Nano is easier for beginners.\n\n6. Add the following to the end of the file `* * * * * /path/to/DiscordChatExporter/cron.sh >/tmp/discordchatexporter.log 2>/tmp/discordchatexportererror.log`. Don't forget to replace the `/path/to/DiscordChatExporter/cron.sh`!\n\n> **Note**:\n> If you don't want logs to be created, replace both `/tmp/discordchatexporter.log` with `/dev/null`.\n\nThen replace the \\*s according to:\n\n\n\n---\n\n**Examples**:\n\n- If you want to execute the script at minute 15 of every hour: `15 * * * *`\n- Every 30 minutes `*/30 * * * *`\n- Every day at midnight `0 0 * * *`\n- Every day at noon `0 12 * * *`\n- Every day at 3, 4 and 6 PM `0 15,16,18 * * *`\n- Every Wednesday at 9 AM `0 9 * * 3`\n\nVerify your cron time [here](https://crontab.guru).\n\n---\n\n**Additional information**\n\nThe week starts on Sunday. 0 = SUN, 1 = MON ... 7 = SUN.\n\nBe aware that if you set the day to '31', the script will only run on months that have the 31st day.\n\n> [Learn more about running a cron job on the last day of the month here](https://stackoverflow.com/questions/6139189/cron-job-to-run-on-the-last-day-of-the-month) (expert).\n\nThe default filename for the exported channel is `YYYY-MM-DD-hh-mm-ss-yourfilename`. You can change it if you'd like.\n\nDon't forget to update your token in the script after it has been reset!\n\n---\n\nSpecial thanks to [@Yudi](https://github.com/Yudi)\n"
},
{
"path": ".docs/Scheduling-MacOS.md",
"content": "# Scheduling exports on macOS\n\n## Creating the script\n\n1. Open TextEdit.app and create a new file\n\n2. Convert the file to a plain text one in 'Format > Make Plain Text' (⇧⌘T)\n\n\n\n3. Paste the following into the text editor:\n\n```bash\n#!/bin/bash\n# Info: https://github.com/Tyrrrz/DiscordChatExporter/blob/prime/.docs\n\nTOKEN=tokenhere\nCHANNELID=channelhere\nDLLFOLDER=dceFOLDERpathhere\nFILENAME=filenamehere\nEXPORTDIRECTORY=dirhere\nEXPORTFORMAT=formathere\n# Available export formats: plaintext, htmldark, htmllight, json, csv\n# /\\ CaSe-SeNsItIvE /\\\n# You can edit the export command on line 43 if you'd like to include more options like date ranges and date format. You can't use partitioning (-p) with this script.\n\n# This variable specifies in which directories the executable programs are located. Don't change it.\nPATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/share/dotnet\n\n# This will verify if EXPORTFORMAT is valid and will set the final file extension according to it. If the format is invalid, the script will display a message and exit.\nif [[ \"$EXPORTFORMAT\" == \"plaintext\" ]]; then\nFORMATEXT=.txt\nelif [[ \"$EXPORTFORMAT\" == \"htmldark\" ]] || [[ \"$EXPORTFORMAT\" == \"htmllight\" ]]; then\nFORMATEXT=.html\nelif [[ \"$EXPORTFORMAT\" == \"json\" ]]; then\nFORMATEXT=.json\nelif [[ \"$EXPORTFORMAT\" == \"csv\" ]]; then\nFORMATEXT=.csv\nelse\necho \"$EXPORTFORMAT - Unknown export format\"\necho \"Available export formats: plaintext, htmldark, htmllight, csv, json\"\necho \"/\\ CaSe-SeNsItIvE /\\\\\"\nexit 1\nfi\n\n# This will change the script's directory to DLLPATH, if unable to do so, the script will exit.\ncd $DLLFOLDER || exit 1\n\n# This will export your chat\n./DiscordChatExporter.Cli export -t $TOKEN -c $CHANNELID -f $EXPORTFORMAT -o $FILENAME.tmp\n\n# This sets the current time to a variable\nCURRENTTIME=$(date +\"%Y-%m-%d-%H-%M-%S\")\n\n# This will move the .tmp file to the desired export location. If unable to do so, it will attempt to delete the .tmp file.\nif ! mv \"$FILENAME.tmp\" \"${EXPORTDIRECTORY//\\\"}/$FILENAME-$CURRENTTIME$FORMATEXT\" ; then\necho \"Unable to move $FILENAME.tmp to $EXPORTDIRECTORY/$FILENAME-$CURRENTTIME$FORMATEXT.\"\necho \"Cleaning up...\"\n if ! rm -Rf \"$FILENAME.tmp\" ; then\n echo \"Unable to remove $FILENAME.tmp.\"\n fi\nexit 1\nfi\nexit 0\n```\n\n4. Replace:\n\n- `tokenhere` with your [Token](Token-and-IDs.md)\n- `channelhere` with a [Channel ID](Token-and-IDs.md)\n- `dceFOLDERpathhere` with DCE's **directory's path** (e.g. `/Users/user/Desktop/DiscordChatExporterFolder`, NOT `/Users/user/Desktop/DiscordChatExporterFolder/DiscordChatExporter.DLL`)\n- `filenamehere` with the exported channel's filename, without spaces\n- `dirhere` with the directory you want the files to be saved at (e.g. `/Users/user/Documents/Discord\\ Exports`)\n- `formathere` with one of the available export formats\n\nTo quickly get file or folder paths, select the file/folder, then hit Command+I (⌘I) and copy what's after `Where:`.\nAfter copying and pasting, make sure the file/folder name is not missing. If a folder has spaces in its name, add `\\` before the spaces, like in the example below:\n\n- `Discord\\ Exports` - Wrong ✗\n- `/Users/user/Documents` - Wrong ✗\n- `/Users/user/Documents/Discord Exports` - Wrong ✗\n- `/Users/user/Documents/Discord\\ Exports/DCE.Cli.dll` - Wrong ✗\n- `/Users/user/Documents/Discord \\Exports` - Wrong ✗\n- `/Users/user/Documents/Discord\\ Exports` - Correct ✓\n- `/Users/user/Desktop/DiscordChatExporter` - Correct ✓\n\n\n\n5. Save the file as `filename.sh`, not `.txt`\n6. Open Terminal.app, type `chmod +x`, press the SPACE key, then drag & drop the `filename.sh` into the Terminal window and hit RETURN. You may be prompted for your password, and you won't be able to see it as you type.\n\n## Creating the .plist file\n\nOpen TextEdit, make a Plain Text (⇧⌘T) and then paste the following into it:\n\n```xml\n\n\n![](\"https://i.imgur.com/MHRVGDi.png\")
\n\n\n\n3. At 'Start a Program', write `powershell -file -ExecutionPolicy ByPass -WindowStyle Hidden \"C:\\path\\to\\filename.ps1\"` in the Program/script text box\n\n\n\n4. Click 'Yes'\n\n\n\n5. Click 'Finish'\n\n\n\n---\n\nSpecial thanks to [@Yudi](https://github.com/Yudi)\n"
},
{
"path": ".docs/Token-and-IDs.md",
"content": "# Obtaining Token and Channel IDs\n\n> [!WARNING]\n> **Do not share your token!** A token gives full access to an account. \n> To reset a user token, change your account password. \n> To reset a bot token, click on [Reset Token](#how-to-export-with-a-bot-token) in the bot settings.\n\n## How to get a user token\n\n**Caution:** [Automating user accounts violates Discord's terms of service](https://support.discord.com/hc/en-us/articles/115002192352-Automated-user-accounts-self-bots-) and may result in account termination. Use at your own risk.\n\n### Through your web browser\n\nPrerequisite step: Navigate to [discord.com](https://discord.com) and login.\n\n#### In Chrome\n\n##### Using the console\n\n1. ![](\"https://i.imgur.com/zdDwIT5.jpg\")
Press Ctrl+Shift+I (⌥+⌘+I on macOS). Chrome's [DevTools](https://developer.chrome.com/docs/devtools/overview) tools will display.\n\n\n
\n\n2. Click the `Console` tab. The [console](https://developer.chrome.com/docs/devtools/console/) will open.\n\n3. Type\n\n ```js\n let m;webpackChunkdiscord_app.push([[Math.random()],{},e=>{for(let i in e.c){let x=e.c[i];if(x?.exports?.getToken){m=x;break}}}]);m&&console.log(\"Token:\",m.exports.getToken());\n ```\n\n into the console and press Enter. The console will display your user token.\n\n##### Using the network monitor\n\n1.
Press Ctrl+Shift+I (⌥+⌘+I on macOS). Chrome's [DevTools](https://developer.chrome.com/docs/devtools/overview) tools will display.\n\n\n
\n\n2.
![](\"https://i.imgur.com/BDeG0zg.png\")
Click the `Network` tab. The [network panel](https://developer.chrome.com/docs/devtools/overview/#network) will open\n\n\n
\n\n3.
![](\"https://i.imgur.com/0Lgj0vk.png\")
Press F5. The page will reload, and the network log (the lower half of the network panel) will display several entries.\n\n\n
\n\n4.
![](\"https://i.imgur.com/rnZG8Id.png\")
Click the text box labelled `Filter` and type `messages`. The entries will filter down to a single request named `messages`. If the request doesn't appear, switch to any other Discord channel to trigger it.\n\n\n
\n\n5.
![](\"https://i.imgur.com/29dE3fR.png\")
Click the entry named `messages`. A panel will open to the right and display details about the entry. Click the `Headers` tab if it isn't already active.\n\n\n
\n\n6.
![](\"https://i.imgur.com/u7CxXAt.png\")
Scroll through the contents of the `Headers` tab until you find an entry beginning with `authorization:`.\n\n\n
\n\n7.
![](\"https://i.imgur.com/dXcXzma.png\")
Right-click the entry and click `copy value`.\n\n\n
\n\n##### Using the storage inspector\n\n1.
Press Ctrl+Shift+I (⌥+⌘+I on macOS). Chrome's [DevTools](https://developer.chrome.com/docs/devtools/overview/) will display.\n\n\n
\n\n2.
![](\"https://i.imgur.com/biAUIop.png\")
Press Ctrl+Shift+M (⌘+Shift+M). Chrome will enter [Device Mode](https://developer.chrome.com/docs/devtools/device-mode/), and the webpage will display as if on a mobile device.\n\n\n
\n\n3.
![](\"https://i.imgur.com/oUDRZoy.png\")
If necessary, click the `»` at the right end of the tab bar, and click `Application`. The [application panel](https://developer.chrome.com/docs/devtools/overview/#application) will display.\n\n\n
\n\n4.
![](\"https://i.imgur.com/sydNPia.png\")
In the menu to the right, under `Storage`, expand `Local Storage` if necessary, then click `https://discord.com`. The pane to the right will display a list of key-value pairs.\n\n\n
\n\n5.
![](\"https://i.imgur.com/qKo0ny9.png\")
In the text box marked `Filter`, type `token`. The entries will filter down to those containing the string `token`.\n\n\n
\n\n6.
![](\"https://i.imgur.com/caj3lQq.png\")
Click the `token` entry. (Note: if the token doesn't display, try refreshing by pressing F5 or ⌘+R on macOS)\n\n\n
\n\n7.
![](\"https://i.imgur.com/SwWFIH4.png\")
Click the text box at the bottom, press Ctrl+A (⌘+A on macOS) then Ctrl+C (⌘+C on macOS) to copy the value to your clipboard.\n\n\n
\n\n#### In Firefox\n\n##### Using the console\n\n1.
![](\"https://i.imgur.com/O34nwdG.png\")
Press Ctrl+Shift+K (⌥+⌘+K on macOS). Firefox’s [web developer tools](https://firefox-source-docs.mozilla.org/devtools-user/) will display at the bottom of the window, and the [web console](https://firefox-source-docs.mozilla.org/devtools-user/console/index.html) will display.\n\n\n
\n\n2. Click the `Console` tab. The [console](https://firefox-source-docs.mozilla.org/devtools-user/console/index.html) will open.\n\n1. Type\n\n ```js\n let m;webpackChunkdiscord_app.push([[Math.random()],{},e=>{for(let i in e.c){let x=e.c[i];if(x?.exports?.getToken){m=x;break}}}]);m&&console.log(\"Token:\",m.exports.getToken());\n ```\n\n into the console and press Enter. The console will display your user token.\n\n##### Using the network monitor\n\n1.
Press Ctrl+Shift+E (⌥+⌘+E on macOS). Firefox’s [web developer tools](https://firefox-source-docs.mozilla.org/devtools-user/) will display at the bottom of the window, and the [network monitor](https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/) will display.\n\n\n
\n\n2.
![](\"https://i.imgur.com/j00QzhU.png\")
Press F5. The page will reload, and the [network request list](https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/request_list/index.html) will populate with entries.\n\n\n
\n\n3.
![](\"https://i.imgur.com/efUCfBO.png\")
Type `messages` into the filter. The network request list will filter out any entries not containing the string `messages`. If the request doesn't appear, switch to any other Discord channel to trigger it.\n\n\n
\n\n4.
![](\"https://i.imgur.com/cdJZ7Q1.png\")
Click `messages`. The [network request details pane](https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/request_details/index.html) will display. The [headers tab](https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/request_details/index.html#network-monitor-request-details-headers-tab) should be active by default. If it isn’t, click it.\n\n\n
\n\n5.
![](\"https://i.imgur.com/zBmq1JW.png\")
Type `authorization` into the text box labelled `Filter Headers`.\n\n\n
\n\n6.
![](\"https://i.imgur.com/O3blcIS.png\")
Scroll down until you see an entry labeled [authorization](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization) under `Request Headers`.\n\n\n
\n\n7.
![](\"https://i.imgur.com/zHYEYoZ.png\")
Right-click the entry labeled `authorization` and select `copy value`.\n\n\n
\n\n##### Using the storage inspector\n\n1.
![](\"https://i.imgur.com/A8jqpkm.png\")
Press Shift+F9. Firefox’s [web developer tools](https://firefox-source-docs.mozilla.org/devtools-user/) will display at the bottom of the window, and the [storage](https://firefox-source-docs.mozilla.org/devtools-user/storage_inspector/index.html) panel will be selected.\n\n\n
\n\n2.
![](\"https://i.imgur.com/TGcbB7f.png\")
Press Ctrl+Shift+M (⌥+⌘+M on macOS). Firefox will toggle [responsive design mode](https://firefox-source-docs.mozilla.org/devtools-user/responsive_design_mode/), and the web page will display as if on a mobile device. (Note: Discord may steal focus and respond to the command by toggling mute. If this happens, return focus to Firefox’s web developer tools by clicking somewhere in it, then try the command again.)\n\n\n
\n\n3.
![](\"https://i.imgur.com/2xWkep9.png\")
In the [storage tree](https://firefox-source-docs.mozilla.org/devtools-user/storage_inspector/index.html#storage-inspector-storage-tree) (the list on the left side of the web developer tools panel), click [Local Storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage). The entry will expand, and the entry `https://discord.com` will display beneath it.\n\n\n
\n\n4.
![](\"https://i.imgur.com/tGlGuOL.png\")
In the storage tree, click `https://discord.com`. The [table widget](https://firefox-source-docs.mozilla.org/devtools-user/storage_inspector/index.html#storage-inspector-table-widget) to the right of the storage tree will display several key-value pairs.\n\n\n
\n\n5.
![](\"https://i.imgur.com/hDNsnZ5.png\")
In the text box labelled `Filter items` at the top of the table widget, enter `token`. The table will now only display entries containing the string `token`.\n\n\n
\n\n6.
![](\"https://i.imgur.com/8fKId1W.png\")
Click the entry `token`. The [sidebar](https://firefox-source-docs.mozilla.org/devtools-user/storage_inspector/index.html#storage-inspector-sidebar) will display. (Note: If the token doesn’t display, try refreshing by pressing F5.)\n\n\n
\n\n7.
![](\"https://i.imgur.com/yD1ZuR9.png\")
Right-click the single entry in the sidebar and select `copy`.\n\n\n
\n\n### Through the desktop app / enabling web developer tools\n\n#### By editing the settings file\n\n1. If Discord is running, exit the application by right-clicking the icon in your taskbar tray and clicking `Quit Discord`.\n\n2. Open Discord's settings file in your preferred text editor. See the following table for help finding it:\n\n | OS | Stable | Canary | Public Test Build (PTB) |\n | ------- | ----------------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------- |\n | Windows | `%APPDATA%\\discord\\settings.json` | `%APPDATA%\\discordcanary\\settings.json` | `%APPDATA%\\discordptb\\settings.json` |\n | macOS | `~/Library/Application Support/discord/settings.json` | `~/Library/Application Support/discordcanary/settings.json` | `~/Library/Application Support/discordptb/settings.json` |\n | Linux | `~/.config/discord/settings.json` | `~/.config/discordcanary/settings.json` | `~/.config/discordptb/settings.json` |\n\n If you use BetterDiscord, use the following table instead:\n\n | OS | Stable | Canary | Public Test Build (PTB) |\n | ------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------- |\n | Windows | `%APPDATA%\\BetterDiscord\\data\\stable\\settings.json` | `%APPDATA%\\BetterDiscord\\data\\canary\\settings.json` | `%APPDATA%\\BetterDiscord\\data\\ptb\\settings.json` |\n | macOS | `~/Library/Application Support/BetterDiscord/data/stable/settings.json` | `~/Library/Application Support/BetterDiscord/data/canary/settings.json` | `~/Library/Application Support/BetterDiscord/data/ptb/settings.json` |\n | Linux | `~/.config/BetterDiscord/data/stable/settings.json` | `~/.config/BetterDiscord/data/canary/settings.json` | `~/.config/BetterDiscord/data/ptb/settings.json` |\n\n3. Insert a blank line after the first curly bracket (`{`), add the text `\"DANGEROUS_ENABLE_DEVTOOLS_ONLY_ENABLE_IF_YOU_KNOW_WHAT_YOURE_DOING\": true,` to it, and save the file. Your file should resemble the following:\n\n```json\n{\n \"DANGEROUS_ENABLE_DEVTOOLS_ONLY_ENABLE_IF_YOU_KNOW_WHAT_YOURE_DOING\": true,\n \"BACKGROUND_COLOR\": \"#202225\",\n \"IS_MAXIMIZED\": true\n}\n```\n\n4. Launch Discord.\n\n5. To find your user token, continue [here](#in-chrome).\n\n#### Via settings menu (BetterDiscord only)\n\n1.
![](\"https://i.imgur.com/mu1g4OF.png\")
Click the User Settings button (the gear icon to the right of your username). Discord’s settings page will open.\n\n\n
\n\n2.
![](\"https://i.imgur.com/qFrIKON.png\")
In the sidebar to the left, click `Settings` under the `BetterDiscord` group. BetterDiscord’s settings page will display.\n\n\n
\n\n3.
![](\"https://i.imgur.com/48Re5kj.png\")
In the main panel to the right, expand the `Developer Settings` group if necessary, and toggle `DevTools` to enabled.\n\n\n
\n\n4. Press Esc. The settings page will close.\n5. To find your user token, continue [here](#in-chrome).\n\n## How to export with a bot token\n\n### Step 1 - Create an application\n\nYou can create a new application or use an existing one. If you want to create a new one:\n\n1. Go to [Discord developer portal](https://discord.com/developers/applications)\n2. Click on **New Application** in the top right corner\n3. Enter a name for your application and click **Create**\n\n### Step 2 - Invite the bot to your server\n\nThe bot needs to be invited to the server you'd like to export from.\n\n1. Go to [Discord developer portal](https://discord.com/developers/applications)\n2. Navigate to **General Information** on the left\n3. Copy the **Application ID**\n4. Open the following URL in your browser, replacing `YOUR_APP_ID` with the copied Client ID:\n\n\n\n```\nhttps://discord.com/oauth2/authorize?scope=bot&permissions=66560&client_id=YOUR_APP_ID\n```\n\n### Step 3 - Ensure message content intent is enabled\n\nIf this option is not enabled, the exported files will be empty.\n\n1. Go to [Discord developer portal](https://discord.com/developers/applications)\n2. Open your Application's settings\n3. Navigate to the **Bot** section on the left\n4. Scroll down to the **Privileged Gateway Intents** section\n5. Enable **Message Content Intent** by toggling the switch\n\n
![](\"https://i.imgur.com/PPm2KKn.png\")
\n\n### Step 4 - Copy the bot token\n\nIf you don't have a bot token yet or if you've lost it, follow these steps to reset it:\n\n1. Go to [Discord developer portal](https://discord.com/developers/applications)\n2. Open your Application's settings\n3. Navigate to the **Bot** section on the left\n4. Under **Token** click **Reset Token**\n5. Click **Yes, do it!** and authenticate to confirm\n\n> **Tip**:\n> As the token is only shown once, make sure to store it in a safe place. If you lose the token, you will have to reset it again.\n\n> [!WARNING]\n> Resetting the token will invalidate the old one. Any integrations relying on the old token will cease to function until they are updated.\n\n\n\n---\n\n## How to get a Server ID or a Channel ID\n\n1. Open Discord Settings\n2. Go to the **Advanced** section\n3. Enable **Developer Mode**\n4. Right-click on the desired server or channel and click **Copy Server ID** or **Copy Channel ID**\n"
},
{
"path": ".docs/Troubleshooting.md",
"content": "# Troubleshooting\n\nWelcome to the Frequently Asked Questions (FAQ) and Troubleshooting page!\nHere you'll find the answers to most of the questions related to **DiscordChatExporter** (DCE for short) and its core features.\n\n- ❓ If you still have unanswered questions _after_ reading this page, feel free to [create a new discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new).\n- 🐞 If you have encountered a problem that's not described here, has not [been discussed before](https://github.com/Tyrrrz/DiscordChatExporter/discussions), and is not a [known issue](https://github.com/Tyrrrz/DiscordChatExporter/issues?q=is%3Aissue), please [create a new discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new) or [open a bug report](https://github.com/Tyrrrz/DiscordChatExporter/issues/new). Don't forget to include your platform (Windows, Mac, Linux, etc.) and a detailed description of your question/problem.\n\n## General questions\n\n### Token stealer?\n\nNo. That's why this kind of software needs to be open-source, so the code can be audited by anyone.\nYour token is only used to connect to Discord's API, it's not sent anywhere else.\nIf you're using the GUI, be aware that your token will be saved to a plain text file unless you disable it in the settings menu.\n\n### Why should I be worried about the safety of my token?\n\nA token can be used to log into your account, so treat it like a password and never share it.\n\n### How can I reset my token?\n\nFollow the [instructions here](Token-and-IDs.md).\n\n### Will I get banned if I use this?\n\nAutomating user accounts is technically against [TOS](https://discord.com/terms), use at your discretion. [Bot accounts](https://discord.com/developers/docs/topics/oauth2#bot-users) don't have this restriction.\n\n### Will the messages disappear from the exported file if I delete a message, delete my account or block a person?\n\nText messages will not be removed from the exported file, but if media, such as images and user avatars, is changed or deleted, it will no longer be displayed. To avoid this, export using the \"Download media\" (`--media`) option.\n\n### Can DCE export messages that have already been deleted?\n\nNo, DCE cannot access them since they have been permanently deleted from Discord's servers.\n\n### Can DCE export private chats?\n\nYes, if your account has access to them.\n\n### Can DCE download images?\n\nYes, and other media too. Export using the \"Download media\" (`--media`) option.\n\n### Can the exported chats be shared?\n\nYes.\n\n### Can DCE export multiple formats at once?\n\nNo, you can only export one format at a time.\n\n### Can DCE recreate the exported chats in Discord?\n\nNo, DCE is an exporter.\n\n### Can DCE reupload exported messages to another channel?\n\nNo, DCE is an exporter.\n\n### Can DCE add new messages to an existing export?\n\nNo.\n\n## First steps\n\n### How can I find my token?\n\nCheck the following page: [Obtaining token](Token-and-IDs.md)\n\n### When I open DCE a black window pops up quickly or nothing shows up\n\nYou might have downloaded the CLI flavor of the app, which is meant to be run in a terminal. Try [downloading the GUI](Getting-started.md#gui-or-cli) instead if that's what you want.\n\n### How can I set DCE to export automatically at certain times?\n\nCheck the following pages to learn how to schedule **DiscordChatExporter.CLI** runs (advanced):\n\n- [Windows scheduling](Scheduling-Windows.md)\n- [macOS scheduling](Scheduling-MacOS.md)\n- [Linux scheduling](Scheduling-Linux.md)\n\n### The exported file is too large, I can't open it\n\nTry opening it with a different program, try partitioning or use a different file format, like `PlainText`.\n\n### I see messages in the export, but they have no content\n\nYour bot is missing the 'Message Content Intent'. Go to the [Discord Developer Portal](https://discord.com/developers/applications), navigate to the 'Bot' section and enable it.\n\n## CLI\n\n### How do I use the CLI?\n\nCheck the following page:\n\n- [Using the CLI](Using-the-CLI.md)\n\nIf you're using **Docker**, please refer to the [Docker Usage Instructions](Docker.md) instead.\n\n### Where can I find the 'Channel IDs'?\n\nCheck the following page:\n\n- [Obtaining Channel IDs](Token-and-IDs.md)\n\n### I can't find Docker exported chats\n\nCheck the following page:\n\n- [Docker usage instructions](Docker.md)\n\n### I can't export Direct Messages\n\nMake sure you're [copying the DM Channel ID](Token-and-IDs.md#how-to-get-a-direct-message-channel-id), not the person's user ID.\n\n## Errors\n\n```yml\nDiscordChatExporter.Domain.Exceptions.DiscordChatExporterException: Authentication token is invalid.\n```\n\n↳ Make sure the provided token is correct.\n\n```yml\nDiscordChatExporter.Domain.Exceptions.DiscordChatExporterException: Requested resource does not exist.\n```\n\n↳ Check your channel ID, it might be invalid. [Read this if you need help](Token-and-IDs.md).\n\n```yml\nDiscordChatExporter.Domain.Exceptions.DiscordChatExporterException: Access is forbidden.\n```\n\n↳ This means you don't have access to the channel.\n\n```yml\nSystem.Net.WebException: Error: TrustFailure ... Invalid certificate received from server.\n```\n\n↳ Try running cert-sync.\n\nDebian/Ubuntu: `cert-sync /etc/ssl/certs/ca-certificates.crt`\n\nRed Hat: `cert-sync --user /etc/pki/tls/certs/ca-bundle.crt`\n\nIf it still doesn't work, try mozroots: `mozroots --import --ask-remove`\n\n## macOS-specific\n\n### DiscordChatExporter is damaged and can’t be opened. You should move it to the Trash.\n\nCheck the [Using the GUI page](Using-the-GUI.md#step-1) for instructions on how to run the app.\n\n---\n\n> ❓ If you still have unanswered questions, feel free to [create a new discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new).\n>\n> 🐞 If you have encountered a problem that's not described here, has not [been discussed before](https://github.com/Tyrrrz/DiscordChatExporter/discussions), and is not a [known issue](https://github.com/Tyrrrz/DiscordChatExporter/issues?q=is%3Aissue), please [create a new discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new) or [open a bug report](https://github.com/Tyrrrz/DiscordChatExporter/issues/new).\n"
},
{
"path": ".docs/Using-the-CLI.md",
"content": "# Using the CLI\n\n## Step 1\n\nAfter extracting the `.zip` archive, open your preferred terminal.\n\n## Step 2\n\nChange the current directory to DCE's folder with `cd C:\\path\\to\\DiscordChatExporter` (`cd /path/to/DiscordChatExporter` on **MacOS** and **Linux**), then press ENTER to run the command.\n\n**Windows** users can quickly get the folder's path by clicking the address bar while inside the folder.\n\n\n**macOS** users can press Command+Option+C (⌘⌥C) while inside the folder (or selecting it) to copy its path to the clipboard.\n\nYou can also drag and drop the folder on **every platform**.\n\n\n## Step 3\n\nNow we're ready to run the commands.\n\nType the following command in your terminal of choice, then press ENTER to run it. This will list all available subcommands and options.\n\n```console\n./DiscordChatExporter.Cli\n```\n\n> **Note**:\n> On Windows, if you're using the default Command Prompt (`cmd`), omit the leading `./` at the start of the command.\n\n> **Docker** users, please refer to the [Docker usage instructions](Docker.md).\n\n## CLI commands\n\n| Command | Description |\n| ----------- | ---------------------------------------------------- |\n| export | Exports a channel |\n| exportdm | Exports all direct message channels |\n| exportguild | Exports all channels within the specified server |\n| exportall | Exports all accessible channels |\n| channels | Outputs the list of channels in the given server |\n| dm | Outputs the list of direct message channels |\n| guilds | Outputs the list of accessible servers |\n| guide | Explains how to obtain token, server, and channel ID |\n\nTo use the commands, you'll need a token. For the instructions on how to get a token, please refer to [this page](Token-and-IDs.md), or run `./DiscordChatExporter.Cli guide`.\n\nTo get help with a specific command, run:\n\n```console\n./DiscordChatExporter.Cli command --help\n```\n\nFor example, to figure out how to use the `export` command, run:\n\n```console\n./DiscordChatExporter.Cli export --help\n```\n\n## Export a specific channel\n\nYou can quickly export with DCE's default settings by using just `-t token` and `-c channelid`.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555\n```\n\n#### Changing the format\n\nYou can change the export format to `HtmlDark`, `HtmlLight`, `PlainText` `Json` or `Csv` with `-f format`. The default\nformat is `HtmlDark`.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -f Json\n```\n\n#### Changing the output filename\n\nYou can change the filename by using `-o name.ext`. e.g. for the `HTML` format:\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -o myserver.html\n```\n\n#### Changing the output directory\n\nYou can change the export directory by using `-o` and providing a path that ends with a slash or does not have a file\nextension.\nIf any of the folders in the path have a space in its name, escape them with quotes (\").\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -o \"C:\\Discord Exports\"\n```\n\n#### Changing the filename and output directory\n\nYou can change both the filename and export directory by using `-o directory\\name.ext`.\nNote that the filename must have an extension, otherwise it will be considered a directory name.\nIf any of the folders in the path have a space in its name, escape them with quotes (\").\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -o \"C:\\Discord Exports\\myserver.html\"\n```\n\n#### Generating the filename and output directory dynamically\n\nYou can use template tokens to generate the output file path based on the server and channel metadata.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -o \"C:\\Discord Exports\\%G\\%T\\%C.html\"\n```\n\nAssuming you are exporting a channel named `\"my-channel\"` in the `\"Text channels\"` category from a server\ncalled `\"My server\"`, you will get the following output file\npath: `C:\\Discord Exports\\My server\\Text channels\\my-channel.html`\n\nHere is the full list of supported template tokens:\n\n- `%g` - server ID\n- `%G` - server name\n- `%t` - category ID\n- `%T` - category name\n- `%c` - channel ID\n- `%C` - channel name\n- `%p` - channel position\n- `%P` - category position\n- `%a` - the \"after\" date\n- `%b` - the \"before\" date\n- `%d` - the current date\n- `%%` - escapes `%`\n\n#### Partitioning\n\nYou can use partitioning to split files after a given number of messages or file size.\nFor example, a channel with 36 messages set to be partitioned every 10 messages will output 4 files.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -p 10\n```\n\nA 45 MB channel set to be partitioned every 20 MB will output 3 files.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 -p 20mb\n```\n\n#### Downloading assets\n\nIf this option is set, the export will include additional files such as user avatars, attached files, images, etc.\nOnly files that are referenced by the export are downloaded, which means that, for example, user avatars will not be\ndownloaded when using the plain text (TXT) export format.\nA folder containing the assets will be created along with the exported chat. They must be kept together.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --media\n```\n\n#### Reusing assets\n\nPreviously downloaded assets can be reused to skip redundant downloads as long as the chat is always exported to the\nsame folder. Using this option can speed up future exports. This option requires the `--media` option.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --media --reuse-media\n```\n\n#### Changing the media directory\n\nBy default, the media directory is created alongside the exported chat. You can change this by using `--media-dir` and\nproviding a path that ends with a slash. All of the exported media will be stored in this directory.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --media --media-dir \"C:\\Discord Media\"\n```\n\n#### Changing the date format\n\nYou can customize how dates are formatted in the exported files by using `--locale` and inserting one of Discord's\nlocales. The default locale is `en-US`.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --locale \"de-DE\"\n```\n\n#### Date ranges\n\n**Messages sent before a date**\nUse `--before` to export messages sent before the provided date. E.g. messages sent before September 18th, 2019:\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --before 2019-09-18\n```\n\n**Messages sent after a date**\nUse `--after` to export messages sent after the provided date. E.g. messages sent after September 17th, 2019 11:34 PM:\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --after \"2019-09-17 23:34\"\n```\n\n**Messages sent in a date range**\nUse `--before` and `--after` to export messages sent during the provided date range. E.g. messages sent between\nSeptember 17th, 2019 11:34 PM and September 18th:\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --after \"2019-09-17 23:34\" --before \"2019-09-18\"\n```\n\nYou can try different formats like `17-SEP-2019 11:34 PM` or even refine your ranges down to\nmilliseconds `17-SEP-2019 23:45:30.6170`!\nDon't forget to quote (\") the date if it has spaces!\nMore info about .NET date\nformats [here](https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings).\n\n#### Filtering messages\n\nUse `--filter` to filter what messages are included in the export.\n\n```console\n./DiscordChatExporter.Cli export -t \"mfa.Ifrn\" -c 53555 --filter \"from:Tyrrrz has:image\"\n```\n\nDocumentation on message filter syntax can be found [here](https://github.com/Tyrrrz/DiscordChatExporter/blob/prime/.docs/Message-filters.md).\n\n### Export channels from a specific server\n\nTo export all channels in a specific server, use the `exportguild` command and provide the server ID through the `-g|--guild` option:\n\n```console\n./DiscordChatExporter.Cli exportguild -t \"mfa.Ifrn\" -g 21814\n```\n\n#### Including threads\n\nBy default, threads are not included in the export. You can change this behavior by using `--include-threads` and\nspecifying which threads should be included. It has possible values of `none`, `active`, or `all`, indicating which\nthreads should be included. To include both active and archived threads, use `--include-threads all`.\n\n```console\n./DiscordChatExporter.Cli exportguild -t \"mfa.Ifrn\" -g 21814 --include-threads all\n```\n\n#### Including voice channels\n\nBy default, voice channels are included in the export. You can change this behavior by using `--include-vc` and\nspecifying whether to include voice channels in the export. It has possible values of `true` or `false`, to exclude\nvoice channels, use `--include-vc false`.\n\n```console\n./DiscordChatExporter.Cli exportguild -t \"mfa.Ifrn\" -g 21814 --include-vc false\n```\n\n### Export all channels\n\nTo export all accessible channels, use the `exportall` command:\n\n```console\n./DiscordChatExporter.Cli exportall -t \"mfa.Ifrn\"\n```\n\n#### Excluding DMs\n\nTo exclude DMs, add the `--include-dm false` option.\n\n```console\n./DiscordChatExporter.Cli exportall -t \"mfa.Ifrn\" --include-dm false\n```\n\n### List channels in a server\n\nTo list the channels available in a specific server, use the `channels` command and provide the server ID through the `-g|--guild` option:\n\n```console\n./DiscordChatExporter.Cli channels -t \"mfa.Ifrn\" -g 21814\n```\n\n### List direct message channels\n\nTo list all DM channels accessible to the current account, use the `dm` command:\n\n```console\n./DiscordChatExporter.Cli dm -t \"mfa.Ifrn\"\n```\n\n### List servers\n\nTo list all servers accessible by the current account, use the `guilds` command:\n\n```console\n./DiscordChatExporter.Cli guilds -t \"mfa.Ifrn\" > C:\\path\\to\\output.txt\n```\n"
},
{
"path": ".docs/Using-the-GUI.md",
"content": "# Using the GUI\n\n## Video tutorial\n\n[](https://youtube.com/watch?v=jjtu0VQXV7I)\n\n> Video by [NoIntro Tutorials](https://youtube.com/channel/UCFezKSxdNKJe77-hYiuXu3Q).\n\n## Guide\n\n### Step 1\n\nAfter extracting the `.zip`, run `DiscordChatExporter.exe` **(Windows)**, or `DiscordChatExporter` **(Linux)**.\n\nIf you're using **macOS**, you'll need to manually grant permission for the app to run. \nIf you skip these steps, the \"DiscordChatExporter is damaged and can’t be opened\" error will be shown.\n\n1. Open Terminal.app. You can search for it in Spotlight (press ⌘ + Space and type \"Terminal\").\n2. Paste the following into the terminal window:\n ```bash\n xattr -rd com.apple.quarantine\n ```\n3. Hit Space once to add a space after the command\n4. Drag and drop DiscordChatExporter.app into the terminal window\n5. Press Return to run the command\n6. Open DiscordChatExporter.app normally\n\n> Apple requires apps to be notarized and signed in order to run on macOS without warnings, which in turn requires an Apple Developer membership ($99/year). This open-source project is distributed for free and without commercial intent.\n\n### Step 2\n\nPlease refer to the on-screen instructions to get your token, then paste your token in the upper text box and hit ENTER or click the arrow (→).\n\n> [!WARNING]\n> **Never share your token!**\n> A token gives full access to an account, treat it like a password.\n\n![](\"https://i.imgur.com/SuLQ5tZ.png\")
\n\n### Step 3\n\nDCE will display your Direct Messages and a sidebar with your server list. Select the channel you would like to export, then click the  button to continue.\n\n> **Note**:\n> You can export multiple channels at once by holding `CTRL` or `SHIFT` while selecting.\n> You can also double-click a channel to export it without clicking the  button.\n\n![](\"https://i.imgur.com/JHMFRh2.png\")
\n\n### Step 4\n\nIn this screen you can customize the following:\n\n- **Output path** - The folder where the exported chat(s) will be saved.\n\n- **Export format** - HTML (Dark), HTML (Light), TXT, CSV and JSON\n\n- **Date range (after/before)** (Optional) - If set, only messages sent in the provided date range will be exported. Only one value (either after or before) is required if you want to use this option.\n > **Note**:\n > Please note that the time defaults to **12:00 AM** (midnight/00:00). This means that if you choose to export between Sep 17th and Sep 18th, messages from Sep 18th won't be exported.\n\n- **Partition limit** (Optional) - Split output into partitions, each limited to this number of messages (e.g. 100) or file size (e.g. 10mb). For example, a channel with 36 messages set to be partitioned every 10 messages will output 4 files.\n\n- **Message Filter** (Optional) - Special notation for filtering the messages that get included in the export. See [Message filters](Message-filters.md) for more info.\n\n- **Format markdown** (Optional) - Disable markdown processing when exporting. You can use this to produce JSON or plain text exports without unwrapping mentions, custom emoji, and certain other special tokens.\n\n- **Download assets** (Optional) - If this option is set, the export will include additional files such as user avatars, attached files, images, etc. Only files that are referenced by the export are downloaded, which means that, for example, user avatars will not be downloaded when using the plain text (TXT) export format. A folder containing the assets will be created along with the exported chat. They must be kept together.\n\n- **Reuse assets** (Optional) - If this option is set, the export will reuse already downloaded assets to skip redundant requests. This option is only available when **Download assets** is enabled.\n\n- **Assets directory path** (Optional) - If this option is set, the export will use the specified directory to store assets from all exported channels in the same place.\n\n> **Note**:\n> You need to scroll down to see all available options.\n\n## Settings\n\n- **Auto-update** - Perform automatic updates on every launch.\nDefault: Enabled\n\n > **Note**:\n > Keep this option enabled to receive the latest features and bug fixes!\n\n- **Dark mode** - Use darker colors in the UI (User Interface).\nDefault: Disabled\n\n- **Persist token** - Persist last used token between sessions.\nDefault: Enabled\n\n- **Show threads** - Controls whether threads are shown in the channel list.\nDefault: none\n\n- **Locale** - Customize how dates are formatted in the exported files.\n\n- **Date format** - Customize how dates are formatted in the exported files in the settings menu ().\n\n- **Parallel limit** - The number of channels that will be exported at the same time.\nDefault: 1\n\n > **Note**:\n > Try to keep this number low so that your account doesn't get flagged.\n\n- **Normalize to UTC** - Convert all dates to UTC before exporting.\n\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug-report.yml",
"content": "name: 🐛 Bug report\ndescription: Report broken functionality.\nlabels: [bug]\n\nbody:\n - type: markdown\n attributes:\n value: |\n - Avoid generic or vague titles such as \"Something's not working\" or \"A couple of problems\" — be as descriptive as possible.\n - Keep your issue focused on one single problem. If you have multiple bug reports, please create a separate issue for each of them.\n - Issues should represent **complete and actionable** work items. If you are unsure about something or have a question, please start a [discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new) instead.\n - Remember that **DiscordChatExporter** is an open-source project funded by the community. If you find it useful, **please consider [donating](https://tyrrrz.me/donate) to support its development**.\n\n ___\n\n - type: input\n attributes:\n label: Version\n description: Which version of the application does this bug affect? Make sure you're not using an outdated version.\n placeholder: v1.0.0\n validations:\n required: true\n\n - type: dropdown\n attributes:\n label: Flavor\n description: Which flavor(s) of the application does this bug affect?\n multiple: true\n options:\n - GUI (Graphical User Interface)\n - CLI (Command-Line Interface)\n validations:\n required: true\n\n - type: input\n attributes:\n label: Platform\n description: Which platform do you experience this bug on?\n placeholder: Docker / Windows 11\n validations:\n required: true\n\n - type: dropdown\n attributes:\n label: Export format\n description: Which export format(s) do you experience this bug with, if applicable?\n multiple: true\n options:\n - HTML\n - TXT\n - JSON\n - CSV\n\n - type: textarea\n attributes:\n label: Steps to reproduce\n description: >\n Minimum steps required to reproduce the bug, including prerequisites, export settings, or other relevant items.\n The information provided in this field must be readily actionable, meaning that anyone should be able to reproduce the bug by following these steps.\n If the bug depends on external factors (such as a specific server, channel, or message), then this field must include the server invite and the corresponding link.\n placeholder: |\n Server invite: https://discord.gg/...\n Channel or message link: https://discord.com/channels/.../...\n\n Export settings:\n - ...\n\n Application settings:\n - ...\n\n Steps:\n - Step 1\n - Step 2\n - Step 3\n validations:\n required: true\n\n - type: textarea\n attributes:\n label: Details\n description: Clear and thorough explanation of the bug, including any additional information you may find relevant.\n placeholder: |\n - Expected behavior: ...\n - Actual behavior: ...\n validations:\n required: true\n\n - type: checkboxes\n attributes:\n label: Checklist\n description: Quick list of checks to ensure that everything is in order.\n options:\n - label: I have looked through existing issues to make sure that this bug has not been reported before\n required: true\n - label: I have provided a descriptive title for this issue\n required: true\n - label: I have made sure that this bug is reproducible on the latest version of the application\n required: true\n - label: I have provided all the information needed to reproduce this bug as efficiently as possible\n required: true\n - label: I have sponsored this project\n required: false\n - label: I have not read any of the above and just checked all the boxes to submit the issue\n required: false\n\n - type: markdown\n attributes:\n value: |\n If you are struggling to provide actionable reproduction steps, or if something else is preventing you from creating a complete bug report, please start a [discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new) instead.\n"
},
{
"path": ".github/ISSUE_TEMPLATE/config.yml",
"content": "blank_issues_enabled: false\ncontact_links:\n - name: ⚠ Feature request\n url: https://github.com/Tyrrrz/.github/blob/prime/docs/project-status.md\n about: Sorry, but this project is in maintenance mode and no longer accepts new feature requests.\n - name: 📖 Documentation\n url: https://github.com/Tyrrrz/DiscordChatExporter/blob/prime/.docs\n about: Find usage guides and frequently asked questions.\n - name: 🗨 Discussions\n url: https://github.com/Tyrrrz/DiscordChatExporter/discussions/new\n about: Ask and answer questions.\n - name: 💬 Discord server\n url: https://discord.gg/2SUWKFnHSm\n about: Chat with the project community.\n"
},
{
"path": ".github/dependabot.yml",
"content": "version: 2\nupdates:\n - package-ecosystem: github-actions\n directory: \"/\"\n schedule:\n interval: monthly\n labels:\n - enhancement\n groups:\n actions:\n patterns:\n - \"*\"\n - package-ecosystem: docker\n directory: \"/\"\n schedule:\n interval: monthly\n labels:\n - enhancement\n groups:\n docker:\n patterns:\n - \"*\"\n - package-ecosystem: nuget\n directory: \"/\"\n schedule:\n interval: monthly\n labels:\n - enhancement\n groups:\n nuget:\n patterns:\n - \"*\"\n"
},
{
"path": ".github/workflows/docker.yml",
"content": "name: docker\n\non:\n workflow_dispatch:\n push:\n branches:\n - prime\n tags:\n - \"*\"\n pull_request:\n branches:\n - prime\n\njobs:\n # Outputs from this job aren't really used, but it's here to verify that the Dockerfile builds correctly\n pack:\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n actions: write\n contents: read\n\n steps:\n - name: Checkout\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n\n - name: Install Docker Buildx\n uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3.12.0\n\n - name: Build image\n run: >\n docker buildx build .\n --file DiscordChatExporter.Cli.dockerfile\n --platform linux/amd64,linux/arm64\n --build-arg VERSION=${{ github.ref_type == 'tag' && github.ref_name || format('999.9.9-ci-{0}', github.sha) }}\n --output type=tar,dest=DiscordChatExporter.Cli.Docker.tar\n\n - name: Upload image\n uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0\n with:\n name: DiscordChatExporter.Cli.Docker\n path: DiscordChatExporter.Cli.Docker.tar\n if-no-files-found: error\n\n deploy:\n # Deploy to DockerHub only on tag push or prime branch push\n if: ${{ github.ref_type == 'tag' || github.ref_type == 'branch' && github.ref_name == 'prime' }}\n\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n contents: read\n\n steps:\n - name: Checkout\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n\n - name: Install Docker Buildx\n uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3.12.0\n\n - name: Login to DockerHub\n run: >\n echo ${{ secrets.DOCKER_TOKEN }} |\n docker login --username tyrrrz --password-stdin\n\n - name: Build & push image\n run: >\n docker buildx build .\n --file DiscordChatExporter.Cli.dockerfile\n --platform linux/amd64,linux/arm64\n --build-arg VERSION=${{ github.ref_type == 'tag' && github.ref_name || format('999.9.9-ci-{0}', github.sha) }}\n --push\n --tag tyrrrz/discordchatexporter:latest\n ${{ github.ref_type == 'tag' && '--tag tyrrrz/discordchatexporter:$GITHUB_REF_NAME' || '' }}\n ${{ github.ref_type == 'tag' && '--tag tyrrrz/discordchatexporter:stable' || '' }}\n"
},
{
"path": ".github/workflows/main.yml",
"content": "name: main\n\non:\n workflow_dispatch:\n push:\n branches:\n - prime\n tags:\n - \"*\"\n pull_request:\n branches:\n - prime\n\nenv:\n DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true\n DOTNET_NOLOGO: true\n DOTNET_CLI_TELEMETRY_OPTOUT: true\n\njobs:\n format:\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n contents: read\n\n steps:\n - name: Checkout\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n\n - name: Install .NET\n uses: actions/setup-dotnet@baa11fbfe1d6520db94683bd5c7a3818018e4309 # v5.1.0\n\n # Build the project separately to discern between build and format errors\n - name: Build\n run: >\n dotnet build\n -p:CSharpier_Bypass=true\n --configuration Release\n\n - name: Verify formatting\n id: verify\n run: >\n dotnet build\n -t:CSharpierFormat\n --configuration Release\n --no-restore\n\n - name: Report issues\n if: ${{ failure() && steps.verify.outcome == 'failure' }}\n run: echo \"::error title=Bad formatting::Formatting issues detected. Please build the solution locally to fix them.\"\n\n test:\n # Tests need access to secrets, so we can't run them against PRs because of limited trust\n if: ${{ github.event_name != 'pull_request' }}\n\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n contents: read\n\n steps:\n - name: Checkout\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n\n - name: Install .NET\n uses: actions/setup-dotnet@baa11fbfe1d6520db94683bd5c7a3818018e4309 # v5.1.0\n\n - name: Run tests\n env:\n DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}\n run: >\n dotnet test\n -p:CSharpier_Bypass=true\n --configuration Release\n --logger \"GitHubActions;summary.includePassedTests=true;summary.includeSkippedTests=true\"\n --collect:\"XPlat Code Coverage\"\n --\n RunConfiguration.CollectSourceInformation=true\n DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Format=opencover\n\n - name: Upload coverage\n uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de # v5.5.2\n with:\n token: ${{ secrets.CODECOV_TOKEN }}\n\n pack:\n strategy:\n matrix:\n app:\n - DiscordChatExporter.Cli\n - DiscordChatExporter.Gui\n rid:\n - win-arm64\n - win-x86\n - win-x64\n - linux-arm\n - linux-arm64\n - linux-musl-x64\n - linux-x64\n - osx-arm64\n - osx-x64\n include:\n - app: DiscordChatExporter.Cli\n asset: DiscordChatExporter.Cli\n - app: DiscordChatExporter.Gui\n # GUI assets aren't suffixed, unlike the CLI assets\n asset: DiscordChatExporter\n\n runs-on: ${{ startsWith(matrix.rid, 'win-') && 'windows-latest' || startsWith(matrix.rid, 'osx-') && 'macos-latest' || 'ubuntu-latest' }}\n timeout-minutes: 10\n\n permissions:\n actions: write\n contents: read\n\n steps:\n - name: Checkout\n uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2\n\n - name: Install .NET\n uses: actions/setup-dotnet@baa11fbfe1d6520db94683bd5c7a3818018e4309 # v5.1.0\n\n - name: Publish app\n run: >\n dotnet publish ${{ matrix.app }}\n -p:Version=${{ github.ref_type == 'tag' && github.ref_name || format('999.9.9-ci-{0}', github.sha) }}\n -p:CSharpier_Bypass=true\n -p:EncryptionSalt=${{ secrets.ENCRYPTION_SALT || 'HimalayanPinkSalt' }}\n -p:PublishMacOSBundle=${{ startsWith(matrix.rid, 'osx-') }}\n --output ${{ matrix.app }}/bin/publish/\n --configuration Release\n --runtime ${{ matrix.rid }}\n --self-contained\n\n - name: Upload app binaries\n uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0\n with:\n name: ${{ matrix.asset }}.${{ matrix.rid }}\n path: ${{ matrix.app }}/bin/publish/\n if-no-files-found: error\n\n release:\n if: ${{ github.ref_type == 'tag' }}\n\n needs:\n - format\n - test\n - pack\n\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n contents: write\n\n steps:\n - name: Create release\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: >\n gh release create ${{ github.ref_name }}\n --repo ${{ github.event.repository.full_name }}\n --title ${{ github.ref_name }}\n --generate-notes\n --verify-tag\n\n deploy:\n needs: release\n\n strategy:\n matrix:\n app:\n - DiscordChatExporter.Cli\n - DiscordChatExporter.Gui\n rid:\n - win-arm64\n - win-x86\n - win-x64\n - linux-arm\n - linux-arm64\n - linux-musl-x64\n - linux-x64\n - osx-arm64\n - osx-x64\n include:\n - app: DiscordChatExporter.Cli\n asset: DiscordChatExporter.Cli\n - app: DiscordChatExporter.Gui\n # GUI assets aren't suffixed, unlike the CLI assets\n asset: DiscordChatExporter\n\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n actions: read\n contents: write\n\n steps:\n - name: Download app binaries\n uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3 # v8.0.0\n with:\n name: ${{ matrix.asset }}.${{ matrix.rid }}\n path: ${{ matrix.app }}/\n\n - name: Set permissions\n if: ${{ !startsWith(matrix.rid, 'win-') }}\n run: |\n [ -f ${{ matrix.app }}/${{ matrix.asset }} ] && chmod +x ${{ matrix.app }}/${{ matrix.asset }} || true\n\n # macOS bundle\n [ -f ${{ matrix.app }}/${{ matrix.asset }}.app/Contents/MacOS/${{ matrix.asset }} ] && chmod +x ${{ matrix.app }}/${{ matrix.asset }}.app/Contents/MacOS/${{ matrix.asset }} || true\n\n - name: Create package\n # Change into the artifacts directory to avoid including the directory itself in the zip archive\n working-directory: ${{ matrix.app }}/\n run: zip -r ../${{ matrix.asset }}.${{ matrix.rid }}.zip .\n\n - name: Upload release asset\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n run: >\n gh release upload ${{ github.ref_name }}\n ${{ matrix.asset }}.${{ matrix.rid }}.zip\n --repo ${{ github.event.repository.full_name }}\n\n notify:\n needs: deploy\n runs-on: ubuntu-latest\n timeout-minutes: 10\n\n permissions:\n contents: read\n\n steps:\n - name: Notify Discord\n uses: tyrrrz/action-http-request@1dd7ad841a34b9299f3741f7c7399f9feefdfb08 # 1.1.3\n with:\n url: ${{ secrets.DISCORD_WEBHOOK }}\n method: POST\n headers: |\n Content-Type: application/json; charset=UTF-8\n body: |\n {\n \"avatar_url\": \"https://raw.githubusercontent.com/${{ github.event.repository.full_name }}/${{ github.ref_name }}/favicon.png\",\n \"content\": \"[**${{ github.event.repository.name }}**](<${{ github.event.repository.html_url }}>) v${{ github.ref_name }} has been released!\"\n }\n retry-count: 5\n"
},
{
"path": ".gitignore",
"content": "# User-specific files\n.vs/\n.idea/\n*.suo\n*.user\n\n# Build results\nbin/\nobj/\n\n# Test results\nTestResults/\n"
},
{
"path": "Directory.Build.props",
"content": "