Btrfs is a great filesystem, but its userland tools are not very user-frienfly yet. As a long-time user, I've developed btrfs-list as a wrapper to make sense out of the btrfs subvolume list command.

You need btrfs-list if either:

• You'd like to have a nice overview of your subvolumes/snapshots
• You've already used ZFS before and you're missing the zfs list command
• You're looking for exactly which snapshot to destroy to regain some space
• You're looking for a more accurate estimation of how much space is remaining on your FS

Basically it turns this: into this:

Prerequisites:

• btrfs-progs v3.10 at least (Jan 2013)
• The quota feature enabled on your Btrfs filesystems (optional, to get space usage per subvolume and snapshot)