params.json

{"name":"Iceberg","body":"# iceberg\r\n## Find the big directories lurking on your disk\r\n\r\n### Introduction\r\n\r\nIceberg is an updated incarnation of an amazingly useful tool, originally written in Java, that\r\n makes it easy to find the big directories that are wasting space on your disks.\r\n\r\nThis version has two parts: a bash script that generates an interactive HTML disk report, and the\r\nJavaScript and CSS that give it its interactivity. Bootstrap and jQuery are also used, but are\r\nloaded from CDNs and so aren't included here.\r\n\r\nThis functionality has proved useful again and again, not only on my Mac laptop, but also on the\r\nvarious Linux machines I work with. That's why the HTML generation is done by a bash script, it\r\nseemed like a good choice for lowest-common denominator in those *nix environments. Usage on\r\nremote servers, which you may or may not have a GUI for, is also the reason for splitting the\r\nreport-generation part from the report-viewing part. Generate the HTML on your remote machine,\r\ndownload it to your local PC, and pop it open in the browser of your choice.\r\n\r\n### Usage\r\n\r\n1. Invoke the bash script, specifying HTML output and the directory to report on, saving the\r\noutput to a file:\r\n\r\n    `iceberg.sh --html ~/Movies > iceberg_movies.html`\r\n    \r\n2. Open the HTML file in your browser (after downloading it to your PC if necessary).\r\n3. By default, directories that are 1GB or larger are highlighted in red. To change that threshold,\r\nclick a size button at the top of the window.\r\n4. Click on folder/directory buttons to expand them and see their subdirectories. Directories\r\nwith no subdirectories cannot be expanded (those buttons are deactivated).\r\n5. Find those directories with old backups, unneeded downloads, etc. that are wasting your disk space,\r\nand go clean them up.\r\n6. Repeat as desired. Remember, the HTML report is a static file. If you add or delete files,\r\nyou'll need to re-run the bash script, and refresh your browser.\r\n\r\n![ScreenShot](https://raw.github.com/cgrayson/iceberg/master/doc/screenshot.jpg)\r\n\r\n### Issues\r\n\r\n* Windows compatibility - There is none, currently. Maybe this would work under cygwin, but I\r\nhaven't tried that yet.\r\n* HTML generation speed - I've tried to make this fast, and it's come a long way from my first\r\nbrute-force approach. But it can still take a long time on a filesystem with lots of subdirectories.\r\n(Note that especially large files or directories are no problem; it's the number of directories\r\nthat matters.) For example, generating the 17MB report for my laptop's home directory takes\r\nabout 10 minutes.\r\n* HTML processing speed - I've tried to make the JavaScript controls fast, too. But for large\r\nreport files, the rendering and processing may be slow. For example, that 17MB report for my\r\nlaptop's home directory takes about 8 seconds to load.","google":"","tagline":"Find the big directories lurking on your disk","note":"Don't delete this file! It's used internally to help with page regeneration."}