{"id":17965071,"url":"https://github.com/phunehehe/philesight","last_synced_at":"2025-11-08T23:02:19.722Z","repository":{"id":8598829,"uuid":"10235496","full_name":"phunehehe/philesight","owner":"phunehehe","description":"Mirror of http://zevv.nl/play/code/philesight/ with minor tweaks","archived":false,"fork":false,"pushed_at":"2013-10-03T06:34:40.000Z","size":136,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-09T07:45:15.475Z","etag":null,"topics":["disk-space","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phunehehe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-05-23T03:58:22.000Z","updated_at":"2020-08-18T06:24:07.000Z","dependencies_parsed_at":"2022-08-27T17:01:48.097Z","dependency_job_id":null,"html_url":"https://github.com/phunehehe/philesight","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phunehehe%2Fphilesight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phunehehe%2Fphilesight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phunehehe%2Fphilesight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phunehehe%2Fphilesight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phunehehe","download_url":"https://codeload.github.com/phunehehe/philesight/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247070769,"owners_count":20878581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["disk-space","ruby"],"created_at":"2024-10-29T12:10:00.835Z","updated_at":"2025-11-08T23:02:14.682Z","avatar_url":"https://github.com/phunehehe.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Summary\n=======\n\nPhilesight is a tool to browse your filesystem and see where the diskspace is\nbeing used at a glance. Philesight is implemented as a simple command line\nprogram that generates PNG files; a wrapper CGI script is supplied to allow\nnavigating through the filesystem.\n\nPhilesight is actually a clone of the filelight program. Wheres filelight is\nment as an interactive, user friendly application for the X-windows desktop,\nphilesight is designed to run on a remote server without graphical user\ninterface.\n\n\nUsage\n=====\n\nSee https://gist.github.com/phunehehe/5097331 for instructions specific to Ubuntu.\n\nPhilesight can be run in different modes: first, the filesystem is indexed\nand the results are stored in a database. When the database is generated, the\ntool can used to generate PNG files with the graphs. The database should be\nupdated every once in a while of course.\n\n * Index bulding:\n\n    ./philesight --db {db} --index {path}\n\n   {db} is the name of the database file that will be generated. It is a good\n   idea to throw away existing database files before indexing to avoid removed\n   files showing in your graph.\n\n   {path} is the top-level directory to start indexing. Usually, '/' is a\n   good choice.\n\n   This process might take some time, since it traverses the whole tree\n   from path-to-index downward and stores the data into the db. Make\n   sure to remove previous database files before indexing.\n\n   You can save on index time and size by using the option '--only-dirs'. This\n   will not store all individual files into the index, only the directory\n   totals. You might want to use this for indexing multi-TB disks.\n\n * PNG generating: In this mode, philesight generates a graph of the\n   filesystem from path and 4 levels downward. i\n\n    ./philesight --db {db} --path {path} --draw {png}\n\n   {db} is the filename of the index file that was generated earlier,\n   {path} is the directory which should be drawn, and {png} is the filename\n   of the to-be-generated PNG image file\n\n\n * CGI: Philesight comes with a CGI module that can be run from within a\n   web server. Edit the configurable parameters in the top of this file\n   to point to the database. Make sure the database file is readable by\n   the webserver and the philesight.rb module can be found by the CGI.\n\n   Available options:\n\n   * $path_db: Path to database file.\n\n   * $path_cache: Optional path to a directory used for caching generated\n     images. Note that this directory should be writable by the httpd user.\n     All images older then $cache_maxage seconds are automatically deleted\n     every time the CGI is invoked.\n\n   * $img_size: graph size. 800 pixels is a good choice.\n\n   * $img_rings: number of rings = depth of graph. 3 or 4 should be ok\n\n   * $img_gradients: use gradient colors in graph (set to 'false' to generate\n     smaller PNG files)\n\n   * $show_list: render list of directories and their sizes blow graph.\n\n\n\n\nDependencies\n============\n\nPhilesight is written in ruby1.8, and requires the berkely-db4 and cairo\nruby libraries.\n\nOn debian, the following should be sufficient:\n\n    apt-get install libdb4.2-ruby1.8 libcairo-ruby1.8\n\nOn Fedora 10, use\n\n    yum -y update\n    yum -y install ruby ruby-cairo ruby-bdb\n\nI've been told the following should work on RedHat/Centos\n\n    yum -y update\n    cd /etc/yum.repos.d/\n    wget http://centos.karan.org/kbsingh-CentOS-Extras.repo\n    wget http://ruby.gfd-dennou.org/products/rpm/RPMS/CentOS/CentOS-DennouRuby.repo\n    yum -y --enablerepo=kbs-CentOS-Testing install ruby bitmap-fonts ruby-bdb ruby-cairo\n\n\nLicense\n=======\n\nThis package is free software; you can redistribute it and/or modify it under\nthe terms of the GNU General Public License as published by the Free Software\nFoundation; version 2 dated June, 1991. This package is distributed in the hope\nthat it will be useful, but WITHOUT ANY WARRANTY; without even the implied\nwarranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\nGeneral Public License for more details.\n\nChangelog\n=========\n\n2012-04-27  Fixed require of 'set' class, seems to be needed on some\n        ruby distributions.\n\n2012-03-22  Added support for proper counting of hard links (thanks\n        Kyle Bygott)\n\n2011-10-15  Fixed typo in help text. Fixed escaping in HTML output.\n\n2011-05-17  Added an option for not storing all files in the index, only\n        directory totals (--only-dirs), this saves considerable on\n        index size. (Thanks Hans Lambermont). Changed size to use\n        IEC 60027-2 format (TiB, GiB, MiB, Kib)\n\n2010-11-10  Now possible to specify --skip \u003cpath\u003e more then once (thanks\n        Lars Gustäbel)\n\n2010-11-05  Flush bugfix\n\n2010-10-04  Flush fd when writing PNG to prevent corrupted PNG output\n\n2009-12-14  Added --one-file-system option (thanks Simon Bland)\n\n2009-02-18  Removed recently added internationalisation support because\n        required libraries are not available in major linux distro's\n\n2009-02-12  Fixed code for ruby 1.9.1 compatibility, added support for\n        non-latin1 filenames. (thanks Stanislav Sedov)\n\n2009-01-05  Added --skip option for skipping files while indexing\n        Updated documentation for RedHat/Centos dependencies\n\n2008-11-20  Updated documentation; added caching support\n\n2008-11-19  Better escaping of CGI parameters, fixed breaking on '+' in\n        pathnames\n\n2008-11-18  Updated documentation for installation on RedHat/Centos\n\n2008-05-29  Added option (use_gradients) to enable/disable gradients\n        in circular graph. Added option to set graph size.\n\n2008-04-16  Added optional table with file list to cgi, some bugfixes,\n        increased default graph size to 800. (thanks Guillaume Sachot)\n\n2008-03-17  Fixed bug where no image was shown with CGI's running\n        on apache-mpm-worker.\n\n2007-03-12  Fixed crash when indexing file named 'rest'\n\n2006-12-09  Workaround for segmentaion fault with ruby 1.8.5\n\n\nBugs\n====\n\n    * Philesight is a ruby program, and thus is not particulary fast.\n    * Indexing could probably be more efficient.\n    * Proper error handling is mostly missing.\n    * Caching is very untested\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphunehehe%2Fphilesight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphunehehe%2Fphilesight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphunehehe%2Fphilesight/lists"}