Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kaladoodotlua/LRhub/llms.txt

Use this file to discover all available pages before exploring further.

Create File is menu option 4, marked [unstable]. It writes a large file filled with ASCII zero characters ('0', byte value 48) of a specified gigabyte size to a chosen destination directory. The file is written in 64 MB chunks with a live progress bar that updates in place, showing write percentage, estimated time remaining, and a visual fill indicator.
This tool is marked [unstable]. Do not run it on a path you cannot afford to fill. Always verify available disk space before specifying a large size.

Input Prompts

1

Destination Path

Enter the full absolute path of the directory where the file should be written. The directory will be created automatically if it does not exist.
! Destination: /home/user/testfiles
Use full absolute paths like /home/username/dir. The shorthand ~/dir is not supported and will not expand correctly.
2

Size in GB

Enter the desired file size as a whole number of gigabytes. The minimum accepted value is 1.
! Size (in GB): 5

What the Tool Does

1

Create Destination Directory

Runs mkdir -p <destination> to ensure the target directory exists before attempting to write.
2

Check Available Disk Space

Queries df -B1 --output=avail <destination> to get the exact number of free bytes. If the requested file size exceeds available space, the tool exits with an error showing both figures.
3

Write in 64 MB Chunks

Opens the output file and writes chunks of 64 MB at a time, each chunk consisting of the ASCII character '0' repeated, until the total target size is reached.
4

Display Live Progress Bar

After each chunk write, the terminal line is updated in place with the current state:
! Written: 42.50% | ETA: 0m 32s | [████████        ]
The bar fills left to right across 20 block positions as writing progresses.

Example Interaction

! Note: Using '~/Directory' won't work please use '/home/user/Directory'

! Destination: /home/user/testfiles
! Size (in GB): 5
! Written: 42.50% | ETA: 0m 32s | [████████        ]
! Written: 100.00% | ETA: 0m 0s  | [████████████████████]
! File created at /home/user/testfiles/5_gb

Output File Naming

The output file is placed directly inside the destination directory. Its name is the size in GB followed by _gb, with no file extension:
Requested SizeOutput File Name
1 GB1_gb
5 GB5_gb
20 GB20_gb
For example, a 5 GB file written to /home/user/testfiles is saved as:
/home/user/testfiles/5_gb

Error Cases

ConditionMessage
Size is less than 1 GB! Size cannot be smaller than 1 GB
Not enough free disk space! Not enough free space! Input: X.XX GB, Available: X.XX GB
Free space cannot be determined! Could not determine free space on target drive
File open/write failure! File operation failed: <error message>
In all error cases the tool exits immediately without writing any data.

Build docs developers (and LLMs) love