Skip to main content

A command-line tool to print free resources in delicious flavors.

Project description

fr is a command-line tool to print free resources in delicious flavors. fr is to free as htop is to top.

It was written because of unhappiness with the bare-bones, hard-to-read free command. I wanted something a bit more… graphical. Instead of this:

             total       used       free     shared    buffers     cached
Mem:       4045216    2159764    1885452          0     192404     942944
-/+ buffers/cache:    1024416    3020800
Swap:            0          0          0

You’ll see something like this (despite Unicode issues on PyPI)…

Free Resources in Blocks of 1 Megabyte (1,000,000 bytes)

DEVICE   VOLUME    CAPACITY       USED       FREE                               MOUNT CACHE
RAM                   4,142      1,421      1,461  ????????????????????????????       1,261
SWAP                      0                        ????????????????????????????

sda1     Ubuntu      18,617      7,000     10,671  ???????????????????????????? /
sda5     Data        88,107     85,218      2,889  ???????????????????????????? /media/Data
sr0      PREDATOR    45,206     45,206          0  ???????????????????????????? /media/PREDATOR

… in fruity colors. Yes, colors can be turned off, units chosen, etc. fr has been tested on Ubuntu Natty/Precise and Windows XP/7 so far.

Install

You’ll need pip, but not virtualenv.

Linux

Need pip? On Ubuntu:

sudo apt-get install python-pip

Or follow the manual instructions.

Next, run this:

sudo pip install fr

If you’d like the development version instead:

sudo pip install https://bitbucket.org/mixmastamyk/fr/get/default.zip

As Udisks is not installed by default on Precise Server (and possibly others), it can be installed if you’d like to print volume labels:

sudo apt-get install udisks

Windows

After eight years this script finally supports Windows. ;)

Need pip? Instructions for installing on Windows. Put "%ProgramFiles%\PythonXX\Scripts" in your PATH.

Next, run these as Admin:

pip install colorama        # want color?
pip install fr[win]         # installs necessary winstats

I’ve given up on Unicode icons (for now) on the Windows console and went back to cp437 for that old-timey DOS feel. Perhaps it should print out “conventional/high” memory too.

Use

Run it ;)

fr

And of course there are a number of options:

fr -h

Note: Output will be in a compact format unless the width of the console is at least 90 characters. Give it more and it will expand to fill available space.

License

Licensed under the GPL, version 3+.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fr, version 0.99s
Filename, size File type Python version Upload date Hashes
Filename, size fr-0.99s.tar.gz (12.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page