• Stars
    star
    1,148
  • Rank 40,634 (Top 0.9 %)
  • Language
    Rust
  • License
    MIT License
  • Created over 5 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A user interface for Windows 10 filesystem compression

Compactor

A friendly user interface to Windows 10 filesystem compression

With modern lightweight compression algorithms running at gigabytes per second per core, it's practically a no-brainer to apply them to filesystems to make better use of storage and IO.

Half-recognising this, Windows 10 ships with a reworked compression system that, while fast and effective, is only exposed to users via a command-line tool β€” compact.exe.

Compactor is here to plug that gap, with a simple GUI utility anyone can use.

Installation v0.10.1 Downloads

Downloads are available from the Github Releases page under Assets, or you can use these direct links:

The 64-bit version is recommended for most users.

If you get "Windows protected your PC" trying to run it, it's just SmartScreen upset the binaries aren't (yet) signed. Click "More info" and "Run anyway" if you judge things to be above-board.

Note this is beta software and comes with no warranty.

Features

Real-time Progress Updates

Compactor's directory analysis updates as it goes. You too can experience the satisfaction of watching the disk-space used counter tick down with each file compressed.

Pause, Resume, Stop

All operations can be paused and interrupted safely at any time. Compactor will finish off what it's doing and stop, or restart where it left off.

Compresstimation

Compactor performs a statistical compressibility check on larger files before passing them off to Windows for compaction. A large incompressible file can be skipped in less than a second instead of tying up your disk for minutes for zero benefit.

Machine Learning

Using advanced condition-based AI logic, Compactor can skip over files that have been previously found to be incompressible, making re-running Compactor on a previously compressed folder much quicker.

(Yes, it's an if statement and a trivial hash database, hush)

Scalable and Fast

Written in Rust, a modern compiled systems programming language from Mozilla, Compactor can cope easily with large folders containing millions of files.

Caveats

Beta Software

While it has been used successfully by thousands of people, Compactor should be used with care. It is intended for compressing replacable software, not precious files.

Make backups. Report bugs. Be nice. You are reminded:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

It's in shouty legal text so you know I mean it.

Data Corruption

There has been one report of data corruption with open SQLite database files. The author has been unable to reproduce this, but file locking was added to version 0.10 which should prevent them from being modified.

Permissions

Compactor currently has no mechanism to elevate its privileges using UAC for protected files. If you're using a limited account you may need to run the program with elevated permissions.

Be careful what you compress. System files should be skipped automatically, and the Windows folder should be in the list of default exclusions (if you want to compact Windows, check out its CompactOS feature), but you almost certainly don't want to blindly run this across your entire C:\ drive.

Modifiable Files

Compaction is designed for files that rarely change β€” any modifications result in the file being uncompressed in its entirety. In fact, simply opening a file in write mode will hang until the file is uncompressed, even if no changes are made.

This generally doesn't matter much for application folders, but it's not great for databases, logs, virtual machine images, and various other things that hopefully mostly live elsewhere.

If a game uses large files and in-place binary patching for updates, it might be worth adding to the exclusions list.

Compatibility with Other Operating Systems

Compaction is only supported on Windows 10 - earlier versions of Windows will be unable to access compressed files, though the rest of the filesystem should remain fully accessible.

Linux and other operating systems will experience similar issues if the NTFS driver they're using lacks support. As of time of writing, NTFS-3G has a third-party plugin for the feature.

This is available on FreeBSD under sysutils/fusefs-ntfs-compression, while users of lesser platforms may need to manually install it like savages.

Compression Results

A totally-not-cherry-picked sample of compression results with the default settings:

Program Size Compacted Ratio
AI War 2 2.43 GiB 1.42 GiB 0.59x
Big Pharma 1.1 GiB 711 MiB 0.37x
Crusader Kings 2 2.19 GiB 1.29 GiB 0.59x
Deus Ex MD 41.31 GiB 28.06 GiB 0.68x
Infinifactory 1.71 GiB 742 MiB 0.58x
Satisfactory 15.82 GiB 10.45 GiB 0.66x
Space Engineers 16.28 GiB 9.4 GiB 0.58x
Stellaris 7.76 GiB 5.21 GiB 0.67x
Subnautica BZ 10.62 GiB 6.40 GiB 0.60x
The Long Dark 7.42 GiB 5.64 GiB 0.76x
Microsoft SDKs 5.91 GiB 2.45 GiB 0.41x
Visual Studio 2017 9.63 GiB 4.77 GiB 0.50x
Windows Kits 5.38 GiB 2.03 GiB 0.38x

A more comprehensive database of results is maintained by the CompactGUI project.

Future

There are many things I want to do with Compactor in future. These include, but are certainly not limited to:

  • Make analysis optional. It isn't fundamentally needed.
  • Multithreaded analysis/compaction for SSDs.
  • GUI rework of some description. The longer I leave this the better Rust should get at it :P
  • Installer. Why does this involve so much XML oh god.
  • Sign the binaries/installer. This appears to involve money.
  • Scheduled task or a background service for set-it-and-forget-it operation.

Feature requests can be discussed in the forum, or you may open an issue.

Alternatives

  • compact.exe is a command-line tool that ships with Windows 10. If you're familiar with the command line and batch files, maybe you'd prefer that. Weirdo.
  • CompactGUI is a popular Visual Basic program that shells out to compact.exe to do its work, instead of using the Windows API directly as Compactor does. It has some... performance issues, particularly with larger folders.
  • NTFS has supported LZNT1 compression since 1995, hidden behind a checkbox under Properties β†’ Advanced Attributes. It's less flexible and has a reputation for poor performance and issues with fragmentation, but is more set-it-and-forget-it.

Are you aware of any others? Do let me know.

Nerdy Technical Stuff

Compactor is primarily written in Rust. The front-end is basically an embedded website driven by the web-view crate. It does not depend on any remote resources or open any ports.

Under the hood it uses DeviceIoControl with FSCTL_SET_EXTERNAL_BACKING and FSCTL_DELETE_EXTERNAL_BACKING, and a few functions from WofApi (Windows Overlay Filesystem). This is, of course, in part thanks to the winapi crate. Eventually I hope to get around to finishing off some of my bindings and contributing them back.

Compresstimation uses a simple linear sampling algorithm, passing blocks through LZ4 level 1 as a compressibility check and averaging across the entire file. The code is available on Github.

The incompressible-files database is simply an append-only list of SipHash128 path hashes. It should be safe to share between multiple instances if you want to compress different drives at the same time. It lives in %APPDATA%\Local\Freaky\Compactor.

Author

Compactor is written by Thomas Hurst, a nerdy, aloof weirdo from the north-east of England, and a programmer for about 25 years.

He mostly works with FreeBSD and focuses on Unix platforms, but uses Windows because he plays games instead of having a social life.

You can find him on Mastodon at @[email protected], or bug him on IRC as Freaky on libera.chat.

More Repositories

1

monotime

A sensible interface to monotonic time in Ruby
Ruby
156
star
2

tarssh

A simple SSH tarpit inspired by endlessh
Rust
127
star
3

cw

A Rust wc clone
Rust
101
star
4

rtss

Relative TimeStamps for Stuff
Rust
51
star
5

zfsnapr

Recursive ZFS snapshot mounter
Ruby
24
star
6

rust-linereader

A fast Rust line reader
Rust
23
star
7

borg-backup.sh

A simple shell script for driving BorgBackup
Shell
20
star
8

fast-memchr

A port of rust-memchr's fallback and SSE2 memchr() to C
C
19
star
9

faccess

Cross-platform file access checks in Rust
Rust
16
star
10

rust-proctitle

A safe cross-platform interface to setting process titles
Rust
16
star
11

checkrestart

sysutils/checkrestart: A FreeBSD tool to find stale processes that may need restarting after an upgrade
C
14
star
12

gcstool

A small tool for creating and searching Golomb Compressed Sets
Rust
13
star
13

rust-filesize

Physical disk use retrieval
Rust
12
star
14

pqsort

A generic partial quicksort macro for C99.
C++
12
star
15

run-one

A BSD-compatible reimplementation of Ubuntu's run-one
Shell
11
star
16

compresstimator

Simple and fast compressibility tester
Rust
10
star
17

mkjail

Create minimal jail environments on FreeBSD
Ruby
9
star
18

elite_shield_tester

A Rust port of Down To Earth Astronomy's Elite Dangerous shield tester
Rust
8
star
19

mkpass

Generates reasonably secure passwords
Rust
5
star
20

annoirc

A bot to annotate IRC with information about posted links
Rust
5
star
21

portacl-rc

A FreeBSD rc(8) script for mac_portacl(4)
Roff
4
star
22

pkg-cruft

Find cruft on pkgng systems like FreeBSD
Ruby
4
star
23

TerraIntrimmer

Trim the notification queue from Terra Invicta saves
Rust
3
star
24

fast-bytecount

A port of the Rust bytecount SSE2 and AVX2 algorithms to C
M4
3
star
25

ruby-reattempt

Yet another Ruby retry library.
Ruby
3
star
26

rust-bitrw

A Rust library for bit-level reading and writing
Rust
3
star
27

esc

Email Search Command, because Email Sucks Completely
Rust
3
star
28

blooming-rust

Disk-backed Bloom Filters for Rust
Rust
3
star
29

par_qsort

A quick and dirty parallel quicksort in Rust
Rust
2
star
30

simplepass

Simple Ruby and Rust password generation
Rust
2
star
31

tikibar

Prototypical Ruby progress bar library
Ruby
2
star
32

ruby-capsicum

A Ruby interface to Capsicum sandboxing
Ruby
2
star
33

blooming-ruby

Ruby BitArray and BloomFilter library
Ruby
1
star
34

quickhash

Multithreaded stream hashing
Rust
1
star
35

IMSErious

Execute commands in response to Dovecot's Internet Message Store Event notifications
Rust
1
star
36

ruby-filemon

A Ruby interface to FreeBSD's filemon(4) device
Ruby
1
star
37

numastat

FreeBSD NUMA domain memory monitor
Python
1
star
38

nfo.fcgi

Newzbin's ancient FastCGI NFO service
Ruby
1
star
39

123-spellcheck

An email spellchecker I made for a friend
Rust
1
star
40

unprivileged

Privilege dropping for Rust
Rust
1
star
41

precache

Read the contents of a directory tree and hope it has useful side-effects
Rust
1
star
42

ruby-gcs

A small Ruby library for creating and searching Golomb Compressed Sets
Ruby
1
star
43

swapflush

Flush swap devices on FreeBSD
C
1
star