df3 0.1.2

Advanced disk free utility - modern alternative to df command
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

# df3 - Advanced Disk Free Utility

[![Crates.io](https://img.shields.io/crates/v/df3.svg)](https://crates.io/crates/df3)
[![Documentation](https://docs.rs/df3/badge.svg)](https://docs.rs/df3)
[![CI](https://github.com/cumulus13/df3/workflows/CI/badge.svg)](https://github.com/cumulus13/df3/actions)
[![License: MIT OR Apache-2.0](https://img.shields.io/badge/License-MIT%20OR%20Apache--2.0-blue.svg)](https://github.com/cumulus13/df3#license)

A modern, cross-platform disk usage viewer with multiple output formats, real-time monitoring, and advanced filtering capabilities.

## Features

- 🚀 **Fast and efficient** - Written in Rust for maximum performance
- 🎨 **Multiple output formats** - Table, JSON, CSV, and more
- 📊 **Real-time monitoring** - Watch mode with configurable refresh interval
- 🔍 **Advanced filtering** - Filter by filesystem type, mount point, and more
- 💻 **Cross-platform** - Works on Linux, macOS, and Windows
- 🎯 **Human-readable output** - Smart size formatting
- 📈 **Progress indicators** - Visual feedback for long operations
- 🔧 **Highly configurable** - Extensive CLI options

## Installation

### From crates.io

```bash
cargo install df3
```

### From source

```bash
git clone https://github.com/cumulus13/df3
cd df3
cargo install --path .
```

## Quick Start

```bash
# Basic usage
df

# Human-readable output
df -H

# JSON output
df --output json

# Watch mode (refresh every 5 seconds)
df --watch 5

# Show only specific filesystem types
df -t ext4 -t xfs

# Exclude filesystem types
df -x tmpfs -x devtmpfs

# Sort by usage percentage
df -S percent -r

# Show total with inode information
df --total -i
```

## Usage

```
Advanced disk free utility - modern alternative to df command

Usage: df [OPTIONS] [MOUNTS]...

Arguments:
  [MOUNTS]...  Mount point(s) to show

Options:
  -H, --human-readable          Show human readable sizes
  -l, --local                   Limit listing to local file systems
  -a, --all                     Include dummy file systems
  -i, --inodes                  Show inode information
  -o, --output <OUTPUT>         Output format [default: table] [possible values: table, json, csv, inodes]
  -B, --block-size <BLOCK_SIZE> Block size [default: 1024]
  -t, --type <FS_TYPE>         Filesystem type to show
  -x, --exclude-type <FS_TYPE> Filesystem type to exclude
  -S, --sort <SORT_FIELD>      Sort by field [possible values: filesystem, size, used, avail, percent, mount]
  -r, --reverse                 Reverse sort order
      --total                   Show total row
  -s, --sync                   Display sync progress
  -w, --watch <SECONDS>        Watch mode - refresh every N seconds
  -V, --version                Print version
  -h, --help                   Print help
```

## Examples

### Basic Usage
```bash
$ df -H
Filesystem      Size   Used  Avail Use% Mounted on
/dev/sda1       256G   180G    76G  70% /
/dev/sdb1       512G   320G   192G  63% /data
```

### JSON Output
```bash
$ df --output json
[
  {
    "filesystem": "/dev/sda1",
    "size": 274877906944,
    "used": 193273528320,
    "available": 81604378624,
    "percent": 70.3,
    "mount_point": "/"
  }
]
```

### Watch Mode
```bash
$ df --watch 2
```

## Configuration

df3 can be configured via a config file at:
- Linux/macOS: `~/.config/df3/config.toml`
- Windows: `%APPDATA%\df3\config.toml`

## Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## License

Licensed under either of:

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## 👤 Author
        
[Hadi Cahyadi](mailto:cumulus13@gmail.com)
    

[![Buy Me a Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/cumulus13)

[![Donate via Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/cumulus13)
 
[Support me on Patreon](https://www.patreon.com/cumulus13)

## Acknowledgments

- Inspired by the Unix/Linux `df` command
- Built with ❤️ using Rust