Troubleshooting and FAQ
Look for the message you see in Messages, or read the Frequently asked questions. If the answer is not here, use the contact page.
Frequently asked questions
Section titled “Frequently asked questions”Does GSplit compress the file?
Does GSplit compress the file?
Section titled “Does GSplit compress the file?”No. Pieces are slices of the original file. To make them smaller, compress the file first; see About Paquet Builder.
The recipient cannot open my pieces with GUnite 3
The recipient cannot open my pieces with GUnite 3
Section titled “The recipient cannot open my pieces with GUnite 3”GUnite 3 does not read GSplit 4 pieces. Turn on the Self-Uniting app so the recipient gets GUnite 4 with the pieces, or have them install GSplit 4.
Can GSplit 4 restore pieces made by another program?
Can GSplit 4 restore pieces made by another program?
Section titled “Can GSplit 4 restore pieces made by another program?”Yes: pieces of every GSplit version, and numbered pieces such as HJSplit .001, 7-Zip volumes, GNU split output or a Total Commander set. See I received pieces.
Why does a split fail on a USB drive with free space?
Why does a split fail on a USB drive with free space?
Section titled “Why does a split fail on a USB drive with free space?”Many USB drives use FAT32, which holds files of at most 4 GB. GSplit warns when your pieces are larger and offers the largest size that fits. NTFS and exFAT have no such limit. See Type and size.
Another program cannot open a file in a deep folder
Another program cannot open a file in a deep folder
Section titled “Another program cannot open a file in a deep folder”GSplit handles paths longer than 260 characters, but many programs, Windows Explorer included, do not. Choose a shorter destination folder.
How do I check that the restored file is identical?
How do I check that the restored file is identical?
Section titled “How do I check that the restored file is identical?”GSplit and GUnite check it for you when they unite a GSplit 4 set. To check a set without restoring it, use Verify only in the Unite view. To compare files yourself, use File checksum.
Where does GSplit keep its settings?
Where does GSplit keep its settings?
Section titled “Where does GSplit keep its settings?”In gsplit-pref.json; see Getting started. Deleting the file resets GSplit to its defaults.
Start-up problems
Section titled “Start-up problems”Could not initialize Edge Chromium!
Section titled “Could not initialize Edge Chromium!”GSplit needs the Microsoft WebView2 Runtime. On Windows 10 and 11, the installer offers to download it; if you skipped that step, install the Evergreen WebView2 Runtime from Microsoft and start GSplit again. On Windows 7, use Runtime 109 instead; see the WebView2 installation instructions. In a portable copy, WebView2Loader_x64.dll must sit next to GSplit.exe.
This part of GSplit could not be loaded
Section titled “This part of GSplit could not be loaded”Select Retry. If it keeps happening, restart or reinstall GSplit.
GSplit.exe was not found next to the shell extension
Section titled “GSplit.exe was not found next to the shell extension”The Explorer menu cannot find GSplit. Reinstall GSplit.
Messages
Section titled “Messages”The source file cannot be read
Section titled “The source file cannot be read”The file was moved or deleted, or another program holds it open. Close that program, or split a copy.
GSplit cannot write to the destination folder
Section titled “GSplit cannot write to the destination folder”You cannot write there, or the drive is read-only or offline. Choose another folder.
Not enough space on the destination
Section titled “Not enough space on the destination”Free some space or choose another destination.
Piece N was not written completely
Section titled “Piece N was not written completely”The disk filled up or the drive failed during the split. Split again to another disk: a set with an incomplete piece cannot be restored.
The destination file system cannot hold a file over the size
Section titled “The destination file system cannot hold a file over the size”Choose smaller pieces, the size GSplit offers, or another destination. See the USB drive question.
A piece with the same name already exists in the destination
Section titled “A piece with the same name already exists in the destination”Choose another folder, or choose what GSplit does under If pieces already exist on the Split the file page.
The pieces are too small to hold any data
Section titled “The pieces are too small to hold any data”Each piece also holds some information about the set, and the first piece holds the Self-Uniting app when you add it. Use larger pieces.
The occurrence pattern was not found
Section titled “The occurrence pattern was not found”The file does not contain the pattern often enough. Check the pattern and the number of occurrences. See Split a text, log or CSV file by lines.
A piece failed verification
Section titled “A piece failed verification”A piece read back differs from what GSplit wrote. Suspect the destination drive and split again to another disk.
The Self-Uniting app needs the piece metadata
Section titled “The Self-Uniting app needs the piece metadata”Choose GSplit set as the piece format on the Other properties page, or turn the app off.
Self-Uniting app not created
Section titled “Self-Uniting app not created”The pieces are written, but GSplit could not copy GUnite next to them. Reinstall GSplit.
Unite and verify
Section titled “Unite and verify”This file is not a piece of a set GSplit can read
Section titled “This file is not a piece of a set GSplit can read”Choose a piece of the set, for example the first one. For pieces made by another program, see I received pieces.
Piece N is missing
Section titled “Piece N is missing”Copy all the pieces to one folder, then choose Retry, or Locate… the piece. Skip this piece gives an incomplete file.
The pieces stop at one piece, but a later piece exists
Section titled “The pieces stop at one piece, but a later piece exists”A piece in the middle of the set is missing. Find it and try again.
Piece N is not piece N of this set
Section titled “Piece N is not piece N of this set”The folder holds a file of another set under that name. Remove it.
Piece N is damaged
Section titled “Piece N is damaged”The piece changed since it was written, usually through a bad download or bad media. Download or copy it again. Continue anyway gives a file that does not match the original.
The output file already exists
Section titled “The output file already exists”Turn on Replace the output file if it exists, or choose another name.
File united with errors, Set verified with errors
Section titled “File united with errors, Set verified with errors”The result does not match the original. GSplit keeps it under another name and replaces no file. Get the damaged pieces again and unite again.
This set has no checksum
Section titled “This set has no checksum”All the pieces are there, but the set carries no checksum (raw pieces and some old sets), so nothing proves the content is unchanged.
Projects
Section titled “Projects”Not a GSplit configuration file
Section titled “Not a GSplit configuration file”The file you opened is not a .gsc project. See Project files and batch lists.
Legacy key not mapped
Section titled “Legacy key not mapped”A GSplit 3 project holds a setting that GSplit 4 does not have. Check the pages after the import; see What's new since GSplit 3.
Exit and error codes
Section titled “Exit and error codes”Scripts get the exit codes of gsplitc and gunitec; the installer has its own exit codes, and the MCP server its error codes.
