{"id":29024567,"url":"https://github.com/ml-opensource/lib-log-viewer","last_synced_at":"2026-05-17T04:43:22.681Z","repository":{"id":85539506,"uuid":"159661220","full_name":"ml-opensource/lib-log-viewer","owner":"ml-opensource","description":"A library for storing and analysing logs within a debugged application","archived":false,"fork":false,"pushed_at":"2019-01-08T13:58:56.000Z","size":681,"stargazers_count":4,"open_issues_count":17,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-09-03T02:34:37.865Z","etag":null,"topics":["android"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ml-opensource.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-11-29T12:14:19.000Z","updated_at":"2024-05-13T15:49:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"1c162925-8dd0-407f-8a31-fff06bcaefbd","html_url":"https://github.com/ml-opensource/lib-log-viewer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ml-opensource/lib-log-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Flib-log-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Flib-log-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Flib-log-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Flib-log-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ml-opensource","download_url":"https://codeload.github.com/ml-opensource/lib-log-viewer/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Flib-log-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281216687,"owners_count":26463033,"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","status":"online","status_checked_at":"2025-10-27T02:00:05.855Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["android"],"created_at":"2025-06-26T04:03:05.543Z","updated_at":"2025-10-27T05:10:47.178Z","avatar_url":"https://github.com/ml-opensource.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lib-log-viewer (Name under discussion)\n\nA library for storing and analysing logs within a debugged application. You can: \n- Group logs into categories (e.g. \"API calls\", \"Database writes\", \"Calculation results\" etc.)\n- Attach common severity levels to logs (e.g. \"Warning\", \"Error\" etc.) as well as add custom ones\n- View logs for a specific category in real time\n- View details for each log \n\n## Future plans \n- Take screenshot together with the log\n- Various log sharing options\n\n# Usage\n\n## Initialize the logging library \n\nYou need to initialize the library before logging anything. Usually you'd want to do this in `onCreate(...)` of your `Application` child class. \n\n```kotlin\nLogger.initialize(context)\n```\n\nBy default, the logs are stored in a Room-backed database. However, you can create your own implementation of `LogRepository` \nand use that instead. \n\n```kotlin\nLogger.initialize(context, myRepository)\n``` \n\n## Logging \n\nYour log entry contains the following information:\n- The time of logging (inserted automatically)\n- A category name to group your logs under (\"General\" by default)\n- A severity level (e.g. warning, error, debug etc.); verbose by default.\n- A tag (optional)\n- A throwable (optional)\n- A log message \n\nYou can store logs with:\n```kotlin\nLogger.log(\n    message,\n    severityLevel,\n    tag,\n    categoryName,\n    throwable\n)\n```\n\nHelper extensions are also provided to reflect the more common Android `Log` class functions:\n```kotlin\nLogger.v(/* arguments without the severity level */)\nLogger.i(/* arguments without the severity level */)\nLogger.d(/* arguments without the severity level */)\nLogger.w(/* arguments without the severity level */)\nLogger.e(/* arguments without the severity level */)\nLogger.wtf(/* arguments without the severity level */)\n```\n\n## Viewing logs\n\nYou can view your logs in the `LogViewerActivity`:\n```kotlin\nLogViewerActivity\n    .createIntent(context)\n    .let { startActivity(it) }\n```\n\n### First a category has to be selected.\n\n![Log categories screenshot](/.readme/img/scr1.png?raw=true \"Log categories screenshot\")\n\n### Then all the logs for that category will be shown.\n\n![Log list screenshot](/.readme/img/scr2.png?raw=true \"Log list screenshot\")\n\n### Landscape orientation allows more message text to be seen. Line numbers are also shown then.\n\n![Landscape log list screenshot](/.readme/img/scr5.png?raw=true \"Landscape log list screenshot\")\n\n### Tapping on a log opens its details.\n\n![Assert log details screenshot](/.readme/img/scr3.png?raw=true \"Assert log details screenshot\")\n![Debug log details screenshot](/.readme/img/scr4.png?raw=true \"Debug log details screenshot\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fml-opensource%2Flib-log-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fml-opensource%2Flib-log-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fml-opensource%2Flib-log-viewer/lists"}