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:
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. :/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.