File-Splitter

Information

A Windows and Console based utility to split large files into smaller parts.

Both the Windows and console versions share the same core library of code. Both versions are independent of each other (ie the Window version does not to gather all the parameters and then pass them to the batch program).

The split files retain the original extension if not custom format is used.
The current part number and the total partnumbers are inserted in the format "_XX(YY)", where XX is the current part number, and YY is the total number of parts. This format can be changed by parameter.

example: splitting console.log into 3 parts generates

console_1(3).log
console_2(3).log
console_3(3).log

Installation

1.- Requirements

.NET Framework 3.5 or newer version is required to execute this tool if is not preinstalled with your OS

Windows 7, 8 and 10 contains a valid .NET Framework already installed. For previous Windows releases please go to microsoft update site and installa a valid .NET Framework

2.- Download

Download the last release from GitHub Relases or from SourceForge.

SourceForge downloads may not be up-to-date with the latest version of GitHub.

3.- Install

This tool only required to download and unzip the content to use the executable inside. No installer is provided

Languages

The graphical interface uses the user desktop language if it is available.

The current available languages are:

Spanish
English
French

How To Use

Split

Command line usage:

fsplit -split <size> <unit> <filePath> [-d] [-f <format>] [-df <folder>] [-lf <file>]"

Parameters:

-h or -? Shows usage help
-split
- Splits the File into parts with this options
  - size
    - Size of parts in "unit"
  - unit
    - unit used for the desired size. Units:
      - 'b' bytes
      - 'kb' Kilobytes
      - 'mb' Megabytes
      - 'gb' Gigabytes
      - 'l' number of lines (usig OS line end detection)
      - 'f' number of files (Splits file size rouding up and use the result as 'bytes' size split)
  - filePath
    - Path of file to be split ex: "C:\console\console.log"
- -d
  - Delete the original file after the split is done correctly.
- -f
  - Uses a custom format for the file names. Using a custom format is required to add an extension The text {0} is replaced with the current part number.
    The text {1} is replaced with the total number of parts expected.
    The format inputs accepts parameters to adapt it to the desired funcionality.
    For you could specify a padding of n positions adding ,n.
    Example of 5 chars padding {0,5} with right align or {0,-5} to left align.
    Also you could specify a numeric filling usin # and 0 after :
    Examples for the file number 15:
    Filling with five 0: {0:00000} this result in '00015'.
    Filling with two and two 0 with - : {0:00-00} this result in '00-15'.
    Filling with three 0 in six positions aligned left {0,6:000} this result in '015 '
- -df
  - Changes the result folder from current folder to the desired folder. The folder is created if not exists.
- -lf
  - Creates a file with the names of all the generated files
- -fe
  - Changes the resulting file encoding. Use any valid encodig name or UTF-8-BOM to force UTF-8 with byte mark order or UTF-8-NOBOM to force UTF-8 file without byte mark order. This flag is only used when splitting by lines. Split by size produces binary files.

Example:

fSplit -split 10230 kb c:\console\console.log

WARNING: Cutting by file size currently cuts lines in half. To keep lines together use the option to split by line numbers, eg:

fSplit -split 100000 l c:\console\console.log

Note 1: you can't use commas as delimiters
Note 2: if you call the program from the console without parameters, it invokes the Windows version.

Join

It's possible to merge again the files using the command line with the "copy" command
For example if you have splitted a text file into two parts "p1.txt" and "p2.txt" with "copy /A p1.txt+p2.txt all.txt" it's possible to merge p1 and p2 in a new file called all.txt
If the files are ASCII use /A flag and if the files are binary use the /B flag to ensure that the content is correctly joined.
Take careful to put all files in the correct order.

Donate

Buy me a coffe to help me continue supporting this project. Buy me a coffe

dubasdey / File-Splitter

readme