https://github.com/xfennec/progress

Linux tool to show progress for cp, mv, dd, ... (formerly known as cv)
https://github.com/xfennec/progress

coreutils linux monitoring

Last synced: about 18 hours ago
JSON representation

Linux tool to show progress for cp, mv, dd, ... (formerly known as cv)

• Host: GitHub
• URL: https://github.com/xfennec/progress
• Owner: Xfennec
• License: gpl-3.0
• Created: 2013-11-22T15:25:33.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-11-19T08:43:10.000Z (2 months ago)
• Last Synced: 2024-12-25T08:04:53.375Z (29 days ago)
• Topics: coreutils, linux, monitoring
• Language: C
• Homepage:
• Size: 271 KB
• Stars: 8,591
• Watchers: 140
• Forks: 313
• Open Issues: 62
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
progress - Coreutils Progress Viewer

=====================

What is it

----------

This tool can be described as a **tiny**, dirty C command

that looks for coreutils basic commands (cp, mv, dd, tar, gzip/gunzip,

cat, etc.) currently running on your system and displays the

**percentage** of copied data. It can also show **estimated time** and **throughput**,

and provides a "top-like" mode (monitoring).

![progress screenshot with cp and mv](https://raw.github.com/Xfennec/progress/master/capture.png)

_(After many requests: the colors in the shell come from [powerline-shell](https://github.com/milkbikis/powerline-shell). Try it, it's cool.)_

`progress` works on Linux, FreeBSD and macOS.

Formerly known as cv (Coreutils Viewer).

How do you install it

---------------------

On deb-based systems (Debian, Ubuntu, Mint, etc.) run:

    apt install progress

On Arch Linux, run:

    pacman -S progress

On Fedora, run:

    dnf install progress

On openSUSE, run:

    zypper install progress

On macOS, with homebrew, run:

    brew install progress

On macOS, with MacPorts, run:

    port install progress

Packaging status:

-----------------

[![Packaging status](https://repology.org/badge/vertical-allrepos/progress.svg?columns=3)](https://repology.org/project/progress/versions)

How do you build it from source

-------------------------------

    make && make install

On FreeBSD, substitute `make` with `gmake`.

It depends on the library ncurses, you may have to install corresponding packages (maybe something like 'libncurses5-dev', 'libncursesw6' or 'ncurses-devel').

How do you run it

-----------------

Just launch the binary, `progress`.

What can I do with it

---------------------

A few examples. You can:

* monitor all current and upcoming instances of coreutils commands in

  a simple window:

        watch progress -q

* see how your download is progressing:

        watch progress -wc firefox

* look at your web server activity:

        progress -c httpd

* launch and monitor any heavy command using `$!`:

        cp bigfile newfile & progress -mp $!

and much more.

How does it work

----------------

It simply scans `/proc` for interesting commands*, and then looks at

directories `fd` and `fdinfo` to find opened files and seek positions,

and reports status for the largest file.

It's very light and compatible with virtually any command.

(*) on macOS, it does the same thing using libproc