{"id":25575501,"url":"https://github.com/b0oml/comiks","last_synced_at":"2026-05-04T15:41:42.954Z","repository":{"id":37266154,"uuid":"499961175","full_name":"b0oml/Comiks","owner":"b0oml","description":"A CLI tool to retrieve authors informations from commits.","archived":false,"fork":false,"pushed_at":"2022-06-29T23:38:49.000Z","size":125,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-28T03:52:04.529Z","etag":null,"topics":["bitbucket","cli","commit","email","git","github","gitlab","leak","osint"],"latest_commit_sha":null,"homepage":"","language":"Python","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/b0oml.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}},"created_at":"2022-06-04T23:54:23.000Z","updated_at":"2024-06-26T13:55:00.000Z","dependencies_parsed_at":"2022-09-20T23:20:32.207Z","dependency_job_id":null,"html_url":"https://github.com/b0oml/Comiks","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/b0oml/Comiks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0oml%2FComiks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0oml%2FComiks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0oml%2FComiks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0oml%2FComiks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/b0oml","download_url":"https://codeload.github.com/b0oml/Comiks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0oml%2FComiks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265495401,"owners_count":23776626,"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":["bitbucket","cli","commit","email","git","github","gitlab","leak","osint"],"created_at":"2025-02-21T02:24:26.968Z","updated_at":"2026-05-04T15:41:42.918Z","avatar_url":"https://github.com/b0oml.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.org/project/comiks/\" alt=\"Latest version\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/v/comiks.svg\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/comiks/\" alt=\"Python versions\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/pyversions/comiks.svg\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/b0oml/Comiks/actions/workflows/main.yml\" alt=\"Latest build\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/workflow/status/b0oml/comiks/main-workflow\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n# Comiks\n\nComiks is a command line tool to retrieve authors informations (names and emails) in the repositories commits of a given user.\n\n![Heading illustration](https://raw.githubusercontent.com/b0oml/Comiks/master/doc/heading.png)\n\n## Installation\n\nYou can install the latest tagged version from PyPI.\n\n```shell\n$ pip install comiks\n```\n\nOr install the latest version from GitHub (branch `master`).\n\n```shell\n$ pip install git+https://github.com/b0oml/Comiks\n```\n\n## Configuration\n\nThe first time `comiks` runs, it will generate a config file `.config/comiks/config.toml` in your home directory. This will be the default configuration file used when using comiks.\n\nBy default, only Github provider is enabled, other providers needs an API key/access token. To enable and configure others providers, you can update the configuration file in your home directory.\n\nIt is also possible to load the configuration file from another path with option `-c, --config`.\n\n```shell\n$ comiks -c ./path/to/config.toml username\n```\n\nIf you wan to create your own configuration file, you can take example on [this one](./comiks/config.toml).\n\n## Usage\n\n```shell\n$ comiks --help\nusage: comiks [-h] [-c CONFIG] [-l HIGHLIGHT] [-p TAGS] [-sb] username\n\nRetrieve authors informations from commits.\n\npositional arguments:\n  username              Username for which to scan commits.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -c CONFIG, --config CONFIG\n                        Custom config file (default is ~/.config/comiks/config.toml).\n  -l HIGHLIGHT, --highlight HIGHLIGHT\n                        Strings to highlight in output, separated by a comma (default is username).\n  -p TAGS, --providers TAGS\n                        Comma-sperated list of tags to select which providers to enable (default is in\n                        config).\n  -sb, --show-branches  Show in which branches authors have been found.\n```\n\n### Examples\n\nNormal scan, use config in home directory.\n\n```shell\n$ comiks b0oml\n```\n\nScan using another config.\n\n```shell\n$ comiks -c my_config.toml b0oml\n```\n\nIn tables output, comiks try to highlight names and emails similar to the given username. You can highlight based on other strings than the username by giving a comma-separated list of strings.\n\n```shell\n$ comiks -l john b0oml\n$ comiks -l john,doe,something b0oml\n```\n\nYou can enable/disable availables providers by updating config.toml. Now, let's imagine you have configured all the providers. But, for a given username, you only want to launch one of the providers. Rather than modifying the config each time this happens, you can select which provider to launch with tags.\n\n```shell\n$ comiks -p github,bitbucket b0oml\n$ comiks -p gitlab b0oml\n```\n\n## Providers\n\nBelow is listed all providers currently implemented.\n\n| Name      | Url                            | Authentication                                        | Enabled by default | Tags        |\n| --------- | ------------------------------ | ----------------------------------------------------- | ------------------ | ----------- |\n| GitHub    | [github.com](github.com)       | Not needed, but allows to get a higher API rate limit | yes                | `github`    |\n| GitLab    | [gitlab.com](gitlab.com)       | Needed                                                | no                 | `gitlab`    |\n| Bitbucket | [bitbucket.org](bitbucket.org) | Needed                                                | no                 | `bitbucket` |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb0oml%2Fcomiks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fb0oml%2Fcomiks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb0oml%2Fcomiks/lists"}