FileSplitter for Equicord and Vencord

FileSplitter splits a user-selected file into 10MB attachment-sized parts, sends each part through the existing client upload flow, and reconstructs the original file locally for recipients who have the plugin.

The project supports source-based installs and an optional compatibility patcher for already-installed Vencord or Equicord clients.

Warning

FileSplitter is an unofficial community project and is not affiliated with or endorsed by Discord Inc., Vencord, or Equicord. Client modifications may violate Discord's Terms of Service and may place a Discord account at risk. Installed-client compatibility mode modifies local client files. Only share files you have the legal right and recipient permission to send. Read LEGAL_NOTICE.md before installing.

Quick Install

Source installation has the smallest additional modification surface. Users who already have an installed Vencord or Equicord client can instead use the compatibility patcher from the latest GitHub release:

1. Fully close Discord.
2. Download the patcher for your OS from the latest release:
   • Windows: FileSplitterPatcher.exe
   • Apple Silicon macOS: FileSplitterPatcher-macos-arm64.zip
3. Run the patcher and review the displayed legal and account-risk notice.
4. Choose Installed Equicord or Installed Vencord.
5. Confirm that you understand the notice, then click Install / Update.
6. Reopen Discord and enable FileSplitter in the plugin list if it is not already enabled.

If Discord is already running during install, restart it after the patcher finishes. The patcher creates a backup and includes restore/status actions.

What It Does

• Adds a Split & Upload button to the chat bar
• Splits files larger than 10MB into numbered chunk uploads
• Re-detects chunk messages automatically when messages load or channels change
• Rebuilds the original file locally when all parts are available
• Shows a merged download card for non-image files
• Shows a merged inline preview card for image files
• Keeps the original filename for downloads
• Avoids the old forced auto-download flow for rebuilt files
• Supports installed Equicord, installed Vencord, and source repo installs
• Includes Windows and Apple Silicon macOS release patchers with backup/restore/status flows

Screenshots

Non-image merged result card

Non-image merged result card on the default Discord theme

Image merged preview card

Chunk uploads in chat

Upload progress toast

Upload complete toast

Current Feature Set

Upload-side behavior

• Files at or below 10MB are left alone and can be sent normally
• Files above 10MB are split into part001, part002, part003, and so on
• Each chunk is uploaded through Discord's normal upload pipeline
• Chunk metadata is sent as JSON message content so the receiving client can reassemble the file
• Upload progress is shown through live toast notifications
• The plugin currently enforces a 500MB per-file soft limit in the UI

Receive-side behavior

• Existing messages are scanned when the plugin starts
• Existing messages are scanned again when a channel is selected
• Message create and message update events are listened to in real time
• Once every chunk for a file is present, the plugin marks the set as mergeable
• Image files get a rebuilt inline preview card
• Non-image files get a rebuilt download card with a file icon
• Downloads happen only when the user clicks Download
• Original chunk rows are hidden once a merged result card is available

UI behavior

• Image results show a large preview and a bottom action row
• Non-image results show a file-type icon, filename, subtitle, and download button
• Result cards are styled to remain readable on the default Discord dark theme
• Failed rebuilds show an error state with a retry action

Patcher behavior

• Can patch Installed Equicord
• Can patch Installed Vencord
• Can copy the plugin into a Vencord source repo
• Can copy the plugin into an Equicord source repo
• Creates backups for installed-client patching
• Supports restore and status checks from CLI and GUI modes

Installation Options

There are three supported ways to use FileSplitter.

Option 1: Compatibility Patcher For Installed Clients

Use this when you already have an installed Equicord or Vencord client and accept the additional risk of modifying its local files. Source installation is preferred when practical.

Download: https://github.com/sioaeko/Equicord-splitLargeFile/releases/latest

Download the patcher for your OS and choose the mode that matches your setup.

Windows

For example, if the exe is in your Downloads folder:

cd "$env:USERPROFILE\Downloads"
.\FileSplitterPatcher.exe

If you cloned this repository and built the exe locally, use the dist path instead:

.\dist\FileSplitterPatcher.exe

Apple Silicon macOS

Download FileSplitterPatcher-macos-arm64.zip, unzip it, then run:

cd ~/Downloads
chmod +x FileSplitterPatcher-macos-arm64
xattr -d com.apple.quarantine FileSplitterPatcher-macos-arm64 2>/dev/null || true
./FileSplitterPatcher-macos-arm64

The macOS build is ad-hoc signed by the release workflow, but it is not notarized by Apple. If Gatekeeper blocks it, remove the quarantine attribute with the xattr command above and run it from Terminal.

Supported release-patcher targets:

• Installed Equicord
• Installed Vencord
• Source Repo (Vencord)
• Source Repo (Equicord)

Installed Equicord / Installed Vencord

1. Fully close Discord.
2. Run the release patcher for your OS from the folder where it was downloaded.
3. Choose Installed Equicord or Installed Vencord.
4. Click Install / Update.
5. Start Discord again.
6. Enable FileSplitter in the plugin list if your client requires it.

The patcher stores a backup next to your client files. Use Restore in the GUI, or node patcher.js --restore / node patcher.js --restore-vencord, to undo the patch.

Source Repo (Vencord / Equicord)

1. Run the release patcher for your OS.
2. Choose Source Repo (Vencord) or Source Repo (Equicord).
3. Select your local repo root.
4. Build/inject your client again.

Option 2: Userplugin Install From Source

Use this if you already maintain a local Vencord/Equicord source checkout and prefer a normal src/userplugins install instead of patching an installed client.

The PR-ready plugin source lives in:

src/equicordplugins/fileSplitter/

For personal installs, copy those files into src/userplugins/fileSplitter/. For an Equicord PR, copy the folder into src/equicordplugins/fileSplitter/, add yourself to EquicordDevs, and target Equicord's dev branch.

Vencord

1. Clone the Vencord source:

   git clone https://github.com/Vendicated/Vencord.git
   cd Vencord

2. Create the userplugin folder:

   mkdir -p src/userplugins/fileSplitter

3. Copy the plugin files:

   curl -o src/userplugins/fileSplitter/index.tsx https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/index.tsx
   curl -o src/userplugins/fileSplitter/native.ts https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/native.ts
   curl -o src/userplugins/fileSplitter/styles.css https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/styles.css
   curl -o src/userplugins/fileSplitter/types.ts https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/types.ts

4. Build and inject:

   pnpm install
   pnpm build
   pnpm inject

Equicord

1. Clone the Equicord source:

   git clone https://github.com/Equicord/Equicord.git
   cd Equicord

2. Create the userplugin folder:

   mkdir -p src/userplugins/fileSplitter

3. Copy the plugin files:

   curl -o src/userplugins/fileSplitter/index.tsx https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/index.tsx
   curl -o src/userplugins/fileSplitter/native.ts https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/native.ts
   curl -o src/userplugins/fileSplitter/styles.css https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/styles.css
   curl -o src/userplugins/fileSplitter/types.ts https://raw.githubusercontent.com/sioaeko/Equicord-splitLargeFile/main/src/equicordplugins/fileSplitter/types.ts

4. Build and inject:

   pnpm install
   pnpm build
   pnpm inject

Option 3: Run The CLI Patcher From This Repo

Use this if you cloned this repository and want to install, restore, or check status from the command line.

npm install
node patcher.js --help

Examples:

node patcher.js --legal
node patcher.js --install --accept-risk
node patcher.js --restore
node patcher.js --status
node patcher.js --install-vencord --accept-risk
node patcher.js --restore-vencord
node patcher.js --status-vencord
node patcher.js --install-source --repo C:\path\to\Vencord --accept-risk

Command meaning:

• --legal: print the legal notice, GPL text, and bundled third-party licenses
• --install: patch installed Equicord
• --restore: restore installed Equicord from backup
• --status: check installed Equicord patch status
• --install-vencord: patch installed Vencord
• --restore-vencord: restore installed Vencord from backup
• --status-vencord: check installed Vencord patch status
• --install-source --repo <path>: copy the source plugin into src/userplugins/fileSplitter
• --accept-risk: required for CLI install commands after reviewing --legal; not required for status or restore

For a release binary, the same commands work after replacing node patcher.js with the downloaded file path:

cd "$env:USERPROFILE\Downloads"
.\FileSplitterPatcher.exe --legal
.\FileSplitterPatcher.exe --install --accept-risk
.\FileSplitterPatcher.exe --install-vencord --accept-risk

# Or, from this repository after building:
.\dist\FileSplitterPatcher.exe --install --accept-risk

For the Apple Silicon macOS release binary:

cd ~/Downloads
./FileSplitterPatcher-macos-arm64 --legal
./FileSplitterPatcher-macos-arm64 --install --accept-risk
./FileSplitterPatcher-macos-arm64 --install-vencord --accept-risk

Build release binaries from this repo:

npm run build:exe
npm run build:mac-arm64

# On macOS, sign the Apple Silicon binary:
npm run build:mac-arm64:signed

How It Works In Practice

Sending files

1. Click the FileSplitter button in the chat bar.
2. Pick a file larger than 10MB.
3. The plugin splits it into numbered chunk uploads.
4. Each chunk is uploaded like a normal Discord attachment.
5. A small metadata message is posted for each chunk set.

Receiving files with FileSplitter installed

1. The client finds chunk metadata messages.
2. It tracks all parts for the same original file.
3. After every part is available, it fetches those attachments locally.
4. It rebuilds the original file in memory.
5. It renders either:
   • an inline image preview card, or
   • a non-image file download card.

Receiving files without FileSplitter

The files are still usable manually. You can download the .part001, .part002, .part003, and later pieces, then join them yourself in order.

Windows (CMD)

copy /b "filename.part001" + "filename.part002" + "filename.part003" "originalfile"

Windows (PowerShell)

Get-Content "filename.part001","filename.part002","filename.part003" -Encoding Byte -ReadCount 0 | Set-Content "originalfile" -Encoding Byte

Linux / macOS

cat filename.part001 filename.part002 filename.part003 > originalfile

Supported Targets

Target	Supported	Notes
Installed Equicord	Yes	Compatibility mode; modifies local client files after explicit consent
Installed Vencord	Yes	Compatibility mode; modifies local client files after explicit consent
Vencord source repo	Yes	Preferred when practical; supported by the patcher and manual install
Equicord source repo	Yes	Preferred when practical; supported by the patcher and manual install
Plain Discord without Vencord/Equicord	No	The patcher does not install a mod client by itself

Technical Details

Item	Description
Chunk Size	10MB
Max UI-enforced file size	500MB
File Formats	All file types
Image Preview Types	Common inline image formats
Metadata Transport	JSON in message content
Upload Path	Existing client upload pipeline; every part remains subject to Discord's server-side checks
Rebuild Path	Local fetch + Blob reconstruction
Chunk Expiry	30 minutes
Part Naming	filename.part001, filename.part002, ...

Troubleshooting

Q: I cannot build the plugin from source A: The release patcher remains available as compatibility mode. Review its notice first because installed-client mode directly modifies local Vencord or Equicord files.

Q: The plugin does not show up after patching A: Fully close Discord, patch the correct target, then restart Discord. If you are using a source repo, rebuild/inject again after copying the plugin.

Q: Installed patching failed A: Make sure you selected the correct installed target: Installed Equicord and Installed Vencord are separate modes.

Q: Auto-merge is not happening A: All chunks must be available in the same channel, and the receiving client must have FileSplitter installed and active.

Q: Why does a user without the plugin not see the rebuilt preview card? A: The rebuilt result card is local client-side UI. Users without the plugin only see the uploaded chunk files and can still merge them manually.

Q: Can this patch plain Discord directly? A: No. The patcher targets Vencord/Equicord installs or source repos. It does not install a custom client on top of plain Discord by itself.

Security And Privacy

• File reconstruction is done locally on the receiving client
• No external merge server, telemetry service, or token collection is used
• Native attachment downloads are restricted to HTTPS Discord attachment CDN URLs
• Every uploaded part remains subject to Discord's normal server-side checks
• Installed patching validates its changes and creates a local backup before modifying client files
• Status and restore actions remain available without accepting installation risk

Responsible Use

• Do not use FileSplitter to evade rate limits, moderation, access controls, payment controls, or other safeguards
• Do not send malware, spam, unlawful material, or files you are not authorized to share
• Respect recipient consent, channel rules, server rules, Discord policies, and applicable law

Credits

• Author: sioaeko
• Original concept: ImTheSquid/SplitLargeFiles
• Full attribution and bundled-runtime notices: THIRD_PARTY_NOTICES.md

License

FileSplitter is distributed under GPL-3.0-or-later. See LEGAL_NOTICE.md and THIRD_PARTY_NOTICES.md.