skip to navigation
skip to content

Not Logged In

fr 1.20

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

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:

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-Saucy), CentOS 6, Windows (XP, 7), and Mac OS X (10.7.5) so far.


Install

You'll need pip, but not virtualenv.

Linux

Need pip? On Ubuntu:

sudo apt-get install python-pip

For Red Hat: s/apt-get/yum/. 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.


Mac OS X

Yes, it supports that too:

sudo pip install -U fr

And off you go.


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+.


Release Notes

  • 1.20 - fix: pipeline UnicodeEncodeError.
  • 1.19 - fix: don't print ansi reset at end of bar when color off.
  • 1.18 - fix: swap bar should be match bold setting.
  • 1.17 - Windows: fix crash on XP, crash on ctypes+colorama
  • 1.16 - Posix: don't install fr.cmd.
  • 1.15 - Darwin: fix widelayout (term size), mount point.
  • 1.14 - Fix: cache colors differed on 256 colors.
  • 1.12 - Darwin: fix subprocess call.
  • 1.11 - Darwin: support TERM=xterm.
  • 1.10 - Now supports Mac OS X (aka "Darwin")
  • 1.01 - Handle negative swap size on WinXP, swap numbers unreliable. :/
 
File Type Py Version Uploaded on Size
fr-1.20.tar.gz (md5) Source 2014-02-22 14KB
  • Downloads (All Versions):
  • 14 downloads in the last day
  • 140 downloads in the last week
  • 525 downloads in the last month