{"id":49882086,"url":"https://github.com/reubenfirmin/lucifer","last_synced_at":"2026-05-15T15:34:44.823Z","repository":{"id":45308766,"uuid":"439666311","full_name":"reubenfirmin/lucifer","owner":"reubenfirmin","description":"CLI utility to parse the output from `lsof` and provide smart analysis/reporting.","archived":false,"fork":false,"pushed_at":"2022-01-15T11:40:56.000Z","size":107,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-05-13T17:27:27.080Z","etag":null,"topics":["linux","lsof","processes"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/reubenfirmin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-18T16:45:32.000Z","updated_at":"2022-05-08T15:52:37.000Z","dependencies_parsed_at":"2022-09-15T20:13:37.343Z","dependency_job_id":null,"html_url":"https://github.com/reubenfirmin/lucifer","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/reubenfirmin/lucifer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenfirmin%2Flucifer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenfirmin%2Flucifer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenfirmin%2Flucifer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenfirmin%2Flucifer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reubenfirmin","download_url":"https://codeload.github.com/reubenfirmin/lucifer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenfirmin%2Flucifer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33071296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["linux","lsof","processes"],"created_at":"2026-05-15T15:34:40.449Z","updated_at":"2026-05-15T15:34:44.817Z","avatar_url":"https://github.com/reubenfirmin.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lucifer 0.5\n\nThe goal of this tool is to parse **lsof** output, and to provide useful summarization. PRs welcomed.\n\n## reports\n\nIt currently provides 3 reports:\n\n### OPEN FILES BY PROCESS\nThis is a list of all processes (with associated metadata), along with the count of files opened by that process. Note that child processes may have files in common with each other.\n\nThe top 5 most common parent PIDs are highlighted so that you can quickly see groups of associated processes.\n\n### OPEN FILES BY TYPE BY USER\nA summary of the number of files, by type, by user.\n\n### INTERNET CONNECTIONS BY USER\nA list of all UDP and TCP connections, by user. Some columns may be hidden in narrow terminals.\n\n## building\n\nOn ubuntu, install `gcc-multilib`.\n\n```\n./build.sh\n```\n\n## usage examples\n\nLucifer parses the output of lsof -F. Any other argument provided to lsof may result in the parsing crashing.\n\n```\nsudo lsof -F | ./lucifer\n\nOR\n\nsudo lsof -F \u003e detail.txt\ncat detail.txt | lucifer\ncat detail.txt | lucifer --process 123 --process=5233\n```\n\n### optional arguments\n\n```\n--err               : send input from stdin through to stderr\n--noformat          : turn off color highlighting\n--process={pid}     : full report on a specific process (may be repeated, e.g. --process=1 --process=2)\n--process={command} : full report on processes matching a particular command (main be repeated, e.g. --process=chrome, --process=firefox)\n```\n\n## status\n\nBeta.\n\n## roadmap\n\n* smart coloring\n  * coloring in network report by common host / open ports\n  * coloring in open files report by users with most open files?\n  * smart coloring in the reports to highlight things worth noticing\n  * color coding for all ranges (generalize logic)\n* cohesive error handling (get rid of stderr pipe through of results)\n* --parent flag to order by parent / parent tree\n* improve table width detection (should be given narrow vs wide rules, maybe can pivot to psql \\x style)\n* network report improvements\n  * highlight listening ports\n* somehow match colors to user terminal (right now assumes dark background)\n* ncurses based UI for browsing different reports / detail view\n\n# kotlin-native\n\nThis project is an exploration of kotlin-native, which is basically functional, but has some real warts (listed here)\nthat don't make it a practical choice for prime time projects yet.\n\n* The biggest that I encountered is that readLine() does not split on newline (0xA); after spending a couple of hours trying to massage the broken output I eventually realized that I could just call C's stdio `fgets` function, which reads a line. Nice. \n* Method references (e.g. ::foo) cause the compiler to crash.\n* Output binary size is very large. This alone is probably enough reason to port this to Go or Rust once it's useful enough.\n* I couldn't get tests to work under Intellij initially. Adding a redundant `jvm{}` target to the build got this working.\n* IDE debugger doesn't work with tests, which is a bummer.\n* `apply` doesn't work. These should be equivalent, but they're not.\n   ```\n        split(\"]\").apply { listOf(get(0).substring(1), get(1).substring(1)) }\n\n        val res = split(\"]\")\n        listOf(res[0].substring(1), res[1].substring(1))\n   ```\n\n# FAQ\n\n## What's with the name?\n\nBad pun. Lucifer = lsof-er. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freubenfirmin%2Flucifer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freubenfirmin%2Flucifer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freubenfirmin%2Flucifer/lists"}