grantr / Slackord2

Slackord2 is a cross-platform application that allows you to migrate Slack messages into a Discord server.

Slackord2

Slackord2 is a cross-platform application that parses JSON chat history file exports from Slack and imports them into Discord instantly. Slackord2 is the .NET6.0 version of the Slackord 1.x Python/Tkinter app with significant feature additions.

Demo

Windows

Slackord2_Win.mp4

Linux/Mac

Slackord2_Linux_Mac.mp4

Features

1. Cross platform - Works on Windows(x86/x64), Mac(x64), and Linux(x64).
2. Post everything - Post messages, images, and attachments to any Discord channel or Direct Message conversation.
3. Robust Debug window - Slackord2 lets you know exactly what's happening in real-time. You'll know what messages are being posted, how they'll be formatted, and what the bot is doing before sending messages to their destination channels.
4. Automatic rate-limiting - Slackord2 limits the messages it sends over time so it doesn't spam your target.
5. Ease-of-use - Slackord2 only needs to be set up once, and it'll remember your bot's token, making future imports easy.
6. Privacy first - Slackord2 checks if user messages have a display name and will attempt to keep real names private unless there isn't one.
7. Data safety - Your data is yours. Slackord2 works completely off your local connection and machine.
8. Update checks - Slackord2 has the ability to check for updates in the Help context menu. Get the latest version with new features easily!

Getting Started

Note: If you need to merge multiple JSON files into one, it is recommended to use this tool.
If you are on the free plan of Slack or need a reliable tool for exporting both private/public Slack JSON files compatible with Slackord2, check out Slackdump!

1. Download the latest Slackord2 release for your OS and extract the contents.
2. Create a Discord bot here by selecting "New Application" at the top-right.
3. Name your bot "Slackord2", or any preferred custom name.
4. Under OAuth2>URL Generator, set the bot's "SCOPES" to "bot". This opens a new menu called "BOT PERMISSIONS" below.
5. In "BOT PERMISSIONS", set the bot's permissions to "Administrator". This allows Slackord2 to post to private channels, too.
6. Copy the "GENERATED URL" link below the "BOT PERMISSIONS", and paste into a browser.
7. Join the bot into your desired server.
8. In the "Bot" page underneath "OAuth2", Upload an image for your bot if desired.
9. Click "Reset Token", select "Yes, do it!", then click the "Copy" button to the left of "Regenerate". Keep this secret token handy.
10. Ensure that both "PUBLIC BOT" and "REQUIRES OAUTH2 CODE GRANT" sliders are turned off.
11. In "Privileged Gateway Intents", tick the slider to enable "MESSAGE CONTENT INTENT".
12. Follow the instructions below based on which Operating System you downloaded Slackord2 for.

Running Slackord2 for Windows

1. Run Slackord2.
2. Select Settings>Enter Bot Token and paste the copied token into the text field. Slackord2 will remember your token if you close it.
3. Select File>Import JSON and select a Slack JSON chat history file to import.
4. Select Settings>Bot Connection>Connect to connect the bot to your server.
5. Visit the Discord channel or DM you wish to import Slack chat history to and type /slackord.
6. Messages will begin posting.

Running Slackord2 for Mac/Linux

1. Copy your bot token into the Token.txt file in the root directory, or leave it blank, run Slackord2 and paste it into the CLI when prompted to do so. Slackord2 will remember your token if you close it.
2. Place any Slack JSON files you wish to parse inside of the Files directory.
3. Run Slackord2.
4. Slackord2 will ask you to pick from a numbered list of JSON files to parse. Enter the numerical value for the JSON file you wish to parse. Parsing will begin and the bot will connect to your Discord server.
5. Visit the Discord channel or DM you wish to import Slack chat history to and type /slackord (case insensitive).
6. Messages will begin posting.
7. Restart the Slackord2 app and repeat. (TODO: Don't require a restart to post a new file.)

Important: Please Read!

1. If you need help, please feel free to get in touch with me on Twitter, or open a new issue if it doesn't already exist. Please ensure you specify which version of Slackord2 you are using, and the Operating System you're running Slackord2 on.
2. Slackord2 is free, and it will always be free. However, if you found Slackord2 worth donating something, you can donate from within Slackord2 by accessing "Donate" from the "Help" context menu, you can sponsor Slackord2 at the top of this repository by clicking the heart (sponsor) button, or click here (PayPal) to donate directly.