diskspace 0.5.0

Friendly command line utility for finding the largest files and directories
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

Branch|Build
---|---
master|![Build Status](https://travis-ci.org/swiftgist/diskspace.svg?branch=master)

# DiskSpace
The program `ds` returns the 20 largest directories and files from the current directory.  The output is human friendly with appropriate units.  For example, the output of the src directory is

```
   14M ./target/debug
   14M ./target/debug/deps
    7M ./target/debug/deps/ds-6f1846660d97a074
    7M ./target/debug/ds-6f1846660d97a074
    4M ./target/debug/deps/ds-cd0cb9a5662c3402
    4M ./target/debug/ds
    4M ./target/release
    4M ./target/release/deps
    4M ./target/release/deps/ds-d307492d3cacef39
    4M ./target/release/ds
  996K ./target/debug/deps/libdiskspace-c8b9796891c5526c.rlib
  996K ./target/debug/libdiskspace.rlib
  996K ./target/debug/deps/libds-5149253a6d6a1a22.rlib
  996K ./target/debug/libds.rlib
   14K ./.git/hooks
   13K .
   12K ./.README.md.swp
    6K ./src
    4K ./.git/hooks/pre-rebase.sample
    3K ./.git/hooks/update.sample
```

This command can help find old browser cache files, a misplaced ISO image or a sudden increase in assets of a game.  

# Examples
To list all entries

```
$ ds -a
```

To restrict to a single filesystem (not on Windows)

```
$ ds -x
```

To reverse the sort

```
$ ds -r
```

To see any skipped files or directories and the error

```
$ ds -v
```

To search multiple directories

```
$ ds /home /local
```

On windows

```
> ds \Users \temp
```

To highlight the sizes in green

```
$ ds -c green
```

To turn off color

```
$ ds -c none
```

To exclude lines containing `iso` and `img`

```
$ ds -e iso img
```

To display only 10 lines

```
$ ds -n 10
```


# Installation
For Debian and RPM based systems, download the latest release from [releases](https://github.com/swiftgist/diskspace/releases). Run

```
$ sudo apt install ./diskspace-0.5.0.deb
```

```
# rpm -ivh ./diskspace-0.5.0.rpm
```

From rust

```
$ cargo install diskspace
```