
Syncord is a CLI-based file synchronization and storage tool that uses Discord as an encrypted file storage.
$$\
$$ |
$$$$$$$\ $$\ $$\ $$$$$$$\ $$$$$$$\ $$$$$$\ $$$$$$\ $$$$$$$ |
$$ _____|$$ | $$ |$$ __$$\ $$ _____|$$ __$$\ $$ __$$\ $$ __$$ |
\$$$$$$\ $$ | $$ |$$ | $$ |$$ / $$ / $$ |$$ | \__|$$ / $$ |
\____$$\ $$ | $$ |$$ | $$ |$$ | $$ | $$ |$$ | $$ | $$ |
$$$$$$$ |\$$$$$$$ |$$ | $$ |\$$$$$$$\ \$$$$$$ |$$ | \$$$$$$$ |
\_______/ \____$$ |\__| \__| \_______| \______/ \__| \_______|
$$\ $$ |
\$$$$$$ |
\______/
Syncord is a CLI-based file synchronization and storage tool that uses Discord as an encrypted file storage.
It allows you to upload files or entire directories to Discord, encrypt and partition them locally, and later download and reconstruct them securely; all through a simple command-line interface or an optional TUI dashboard.
Syncord is distributed as a single executable (syncord.exe) built using PyInstaller. The executable can be placed directly in your system PATH and used from anywhere.
π End-to-end encryption
π¦ Automatic file partitioning
π Directory uploads
π₯οΈ CLI-first design
PATHπ§ TUI dashboard
π Usage statistics
ποΈ Local metadata database
syncord.exePATHsyncord --help
Syncord can now be invoked from any directory.
Both the Discord bot token and the Guild ID are mandatory.
syncord setup --token YOUR_DISCORD_BOT_TOKEN --guild-id YOUR_GUILD_ID --encryption-key
syncord upload file.ext
syncord upload folder_name
Behavior:
syncord download folder_on_syncord/file
Syncord will:
NOTE:
If no folder is provided, syncord assume it to be default where every file is uploaded.
syncord dashboard
The dashboard provides:
syncord stats
Displays:
syncord setup Mandatory initial configuration
syncord upload Upload a file or directory
syncord download Download and reconstruct a file
syncord dashboard Launch terminal UI dashboard
syncord stats Show usage statistics
Syncord assumes you trust your local system; not Discord.
dist/
βββ syncord.exe # executable
core/
βββ db_manager.py # SQLite metadata handling
βββ setup.py # Configuration & setup logic
βββ partition.py # File chunking & reconstruction
βββ tui.py # Terminal UI dashboard
βββ encrypter.py # Encryption & Decryption
βββ discord_handler.py # discord bot logic
files/
βββ uuid/file.bin # temp storage
main.py # CLI entry point
This project is intended for educational and personal use.
Ensure compliance with Discordβs Terms of Service when using Syncord.
Issue you might face and should be fixed soon:
partition.py a little.