{"id":37196346,"url":"https://github.com/kevinburke/logrole","last_synced_at":"2026-01-14T22:50:22.180Z","repository":{"id":57531593,"uuid":"71946877","full_name":"kevinburke/logrole","owner":"kevinburke","description":"Twilio log viewer / dashboard replacement. Faster than the Twilio API","archived":false,"fork":true,"pushed_at":"2024-03-21T04:56:28.000Z","size":5691,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-06-20T10:18:23.331Z","etag":null,"topics":["client","dashboard","golang","twilio"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"saintpete/logrole","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevinburke.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-25T23:16:05.000Z","updated_at":"2024-01-30T19:28:17.000Z","dependencies_parsed_at":"2023-01-22T01:58:34.236Z","dependency_job_id":null,"html_url":"https://github.com/kevinburke/logrole","commit_stats":null,"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"purl":"pkg:github/kevinburke/logrole","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinburke%2Flogrole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinburke%2Flogrole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinburke%2Flogrole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinburke%2Flogrole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinburke","download_url":"https://codeload.github.com/kevinburke/logrole/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinburke%2Flogrole/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28436934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T22:37:52.437Z","status":"ssl_error","status_checked_at":"2026-01-14T22:37:31.496Z","response_time":107,"last_error":"SSL_read: 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":["client","dashboard","golang","twilio"],"created_at":"2026-01-14T22:50:21.193Z","updated_at":"2026-01-14T22:50:22.086Z","avatar_url":"https://github.com/kevinburke.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Logrole\n\nLogrole is a faster, usable, fine-grained client for exploring your Twilio\nlogs. If you need to search your Twilio Logs, this is the tool you should be\nusing.\n\n\u003cimg alt=\"Picture of Logrole\" src=\"https://kev.inburke.com/rawblog/images/logrole.png\" /\u003e\n\n- [Customizable permissions][user-settings] for each user browsing the site -\nlimit access to SMS/MMS bodies, resources older than a certain age, recordings,\ncalls, call from, etc. etc.\n\n- To-the-hour, timezone-aware resource search, specific to each user.\n\n- Account Sid and image/recording URLs are hidden from end users at all times,\n  and MMS/recordings require specific permissions to access.\n\n- Click-to-copy sids and phone numbers.\n\n- Tab to search: start typing the URL in the tab bar, then press \u0026lt;tab\u0026gt;.\n  Paste any SID to immediately jump to that page.\n\n\u003cimg alt=\"Tab to search demo\" src=\"https://thumbs.gfycat.com/BarrenColorlessJackrabbit-size_restricted.gif\" /\u003e\n\n[user-settings]: https://godoc.org/github.com/kevinburke/logrole/config#UserSettings\n\n## It Is Really Fast\n\nLogrole fetches and caches the first page of every result set every 30 seconds,\nand any time you page through records, the next page is prefetched and cached\nbefore you click on it. This means paging through your Twilio logs via Logrole\nis *significantly faster* than viewing results in your Dashboard or via the\nAPI! If you don't believe me, the request latencies are displayed at the bottom\nof every page; they're frequently 10ms and very rarely above 200ms.\n\nLogrole uses hand-written HTML, one CSS file, one font, and close to no\nJavascript, so render times and memory performance are very good.\n\nIf you need to search your Twilio Logs, this is the tool you should be using.\n\n[Read more about what makes Logrole fast][blog-post].\n\n[blog-post]: https://kev.inburke.com/kevin/logrole-api-client-speed/\n\n## Installation\n\nTo install Logrole, run\n\n```bash\ngo get -u github.com/kevinburke/logrole/...\n```\n\nYou will need a working [Go environment][go-env]; I recommend setting the\nGOPATH environment variable to `$HOME/go` in your .bashrc or equivalent.\n\n```bash\nexport GOPATH=\"$HOME/go\"\n```\n\nThe `vendor` directory contains a list of dependencies (and suggested versions)\nin `vendor/vendor.json`. To download these into your `vendor` directory, run\n`make deps`. You can also use `go install ./...` to download the latest version\nof every dependency into the normal place in your `$GOPATH`.\n\n## Configuration and Deployment\n\nThere are two main ways to deploy Logrole. Either:\n\n- Write all settings to a `config.yml` file (a sample is in\n[config.sample.yml][config-sample]), then run `logrole_server\n--config=config.yml`.\n\nOr:\n\n- Set all configuration as environment variables. Run\n`logrole_write_config_from_env \u003e config.yml` to write all those environment\nvariables to a config.yml file. Follow the steps in (1).\n\nFor more information, please [see the Settings documentation][settings-docs].\n\n[settings-docs]: https://github.com/kevinburke/logrole/blob/master/docs/settings.md\n[config-sample]: https://github.com/kevinburke/logrole/blob/master/config.sample.yml\n\n## Authentication\n\nLogrole supports three authentication modes: none, basic auth,\nand Google OAuth. For more information, [see the Settings\ndocumentation][settings-auth-docs].\n\n[settings-auth-docs]: https://github.com/kevinburke/logrole/blob/master/docs/settings.md#authentication\n\n## Local Development\n\nLogrole is written in Go; you'll need a [working Go environment][go-env]\nrunning at least Go 1.7. Follow the instructions here to set one up:\nhttps://golang.org/doc/install.\n\n[go-env]: https://golang.org/doc/install\n\nTo check out the project, run `go get -u github.com/kevinburke/logrole/...`.\n\nTo start a development server, run `make serve`. This will start a server on\n[localhost:4114](http://localhost:4114).\n\nBy default we look for a config file in `config.yml`. The values for this\nconfig file can be found in the FileConfig struct in `config/settings.go`.\nThere's an example config file at `config.sample.yml`.\n\n## Run the tests\n\nPlease run the tests before submitting any changes. Run `make test` to run the\ntests, or run `make race-test` to run the tests with the race detector enabled.\n\n## View the documentation\n\nRun `make docs`.\n\n## Vendoring\n\nLogrole is available as a library, which means the `vendor` folder is\nshipped empty. A suggested set of dependency versions is available in\n`vendor/vendor.json`. To download these dependencies to your project, run\n`govendor sync`.\n\n## Errata\n\nThe Twilio Dashboard displays Participants for completed Conferences, but [this\nfunctionality is not available via the API][issue-4]. Please [contact Support\nto request this feature][support] if you'd like it to be available in Logrole.\n\nThe Start/End date filters may only work in Chrome.\n\n[support]: mailto:help@twilio.com\n[issue-4]: https://github.com/kevinburke/logrole/issues/4\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinburke%2Flogrole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinburke%2Flogrole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinburke%2Flogrole/lists"}