Skip to content
GSplit

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.

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?

In gsplit-pref.json; see Getting started. Deleting the file resets GSplit to its defaults.

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.

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.

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.

Free some space or choose another destination.

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.

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 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 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.

The pieces are written, but GSplit could not copy GUnite next to them. Reinstall GSplit.

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.

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.

The folder holds a file of another set under that name. Remove it.

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.

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.

All the pieces are there, but the set carries no checksum (raw pieces and some old sets), so nothing proves the content is unchanged.

The file you opened is not a .gsc project. See Project files and batch lists.

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.

Scripts get the exit codes of gsplitc and gunitec; the installer has its own exit codes, and the MCP server its error codes.

Back to top

Screenshot