{"id":16157440,"url":"https://github.com/welpo/doteki-action","last_synced_at":"2026-01-19T22:31:28.676Z","repository":{"id":218091347,"uuid":"745553333","full_name":"welpo/doteki-action","owner":"welpo","description":"Run dōteki to add dynamic content to your GitHub profile.","archived":false,"fork":false,"pushed_at":"2025-12-31T14:10:14.000Z","size":403,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-04T05:21:07.411Z","etag":null,"topics":["automation","doteki","github-profile","github-profile-readme-generator","plugins"],"latest_commit_sha":null,"homepage":"https://doteki.org","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/welpo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-01-19T15:32:38.000Z","updated_at":"2025-12-31T14:10:18.000Z","dependencies_parsed_at":"2024-06-05T03:48:09.144Z","dependency_job_id":"b5e65c2b-6296-454c-8f22-fea7d4a14b52","html_url":"https://github.com/welpo/doteki-action","commit_stats":null,"previous_names":["welpo/doteki-action"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/welpo/doteki-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/welpo%2Fdoteki-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/welpo%2Fdoteki-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/welpo%2Fdoteki-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/welpo%2Fdoteki-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/welpo","download_url":"https://codeload.github.com/welpo/doteki-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/welpo%2Fdoteki-action/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28587240,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T20:45:59.482Z","status":"ssl_error","status_checked_at":"2026-01-19T20:45:41.500Z","response_time":67,"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":["automation","doteki","github-profile","github-profile-readme-generator","plugins"],"created_at":"2024-10-10T01:49:32.691Z","updated_at":"2026-01-19T22:31:28.657Z","avatar_url":"https://github.com/welpo.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://doteki.org/\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/welpo/doteki/main/website/static/img/doteki-logo-text.png\" width=\"300\" alt=\"doteki logo: a river passing through a bamboo forest\"\u003e\n    \u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/welpo/doteki-action/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/welpo/doteki-action?style=flat-square\u0026labelColor=202b2d\u0026color=5E936C\" alt=\"GitHub version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://doteki.org/docs\"\u003e\n        \u003cimg src=\"https://img.shields.io/website?url=https%3A%2F%2Fdoteki.org\u0026style=flat-square\u0026label=docs\u0026labelColor=202b2d\u0026color=5E936C\" alt=\"Documentation\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/welpo/doteki-action/actions/workflows/ci.yaml\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/welpo/doteki/ci.yaml?style=flat-square\u0026labelColor=202b2d\u0026color=5E936C\" alt=\"Build status\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/welpo/doteki/blob/main/COPYING\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/license/welpo/doteki?style=flat-square\u0026labelColor=202b2d\u0026color=5E936C\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/welpo/git-sumi\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/clean_commits-git--sumi-0?style=flat-square\u0026labelColor=202b2d\u0026color=5E936C\" alt=\"Clean commits\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://doteki.org\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/powered_by-d%C5%8Dteki-0?style=flat-square\u0026labelColor=202b2d\u0026color=5E936C\" alt=\"Powered by dōteki\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# 🎋 Run dōteki Action\n\nThis GitHub action runs [dōteki](https://doteki.org) to update your GitHub profile README with dynamic content.\n\n## Usage\n\n1. Follow the [Initial Setup instructions from dōteki](https://doteki.org/docs) to set up `doteki.toml` and the matching markers in `README.md`.\n\n2. In your profile repository, create the workflow file `.github/workflows/doteki.yaml` with the following content:\n\n```yaml\nname: Update README with dōteki\n\non:\n  push:\n  workflow_dispatch:\n  schedule:\n    - cron: '51 * * * *'  # Every hour at XX:51.\n\njobs:\n  update-readme:\n    runs-on: ubuntu-latest\n    permissions:\n      contents: write  # Necessary to push changes.\n    steps:\n      - name: Run dōteki action\n        uses: welpo/doteki-action@main\n        env:\n          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n```\n\nThis workflow will run every time you push to your repository, every hour at XX:51, and when you manually trigger it from the Actions tab.\n\n\u003cdetails\u003e\n\u003csummary\u003eWhat's inside the workflow file?\u003c/summary\u003e\n\u003cul\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003ename\u003c/code\u003e:\u003c/b\u003e 'Update README with dōteki' labels the action. You'll see this name in the Actions tab.\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003eon\u003c/code\u003e:\u003c/b\u003e Indicates when the action should run. In this case, it runs on push, when manually triggered, and every hour at XX:51.\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003ejobs\u003c/code\u003e:\u003c/b\u003e The 'update-readme' job defines the action's tasks.\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003eruns-on\u003c/code\u003e:\u003c/b\u003e The job runs on the latest Ubuntu version ('ubuntu-latest').\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003epermissions\u003c/code\u003e:\u003c/b\u003e 'contents: write' allows changes to the repository. Otherwise the README couldn't be updated.\u003c/li\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003esteps\u003c/code\u003e:\u003c/b\u003e\n        \u003cul\u003e\n            \u003cli\u003eRuns the latest version of the dōteki action ('welpo/doteki-action@main').\u003c/li\u003e\n        \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003cb\u003e\u003ccode\u003eenv\u003c/code\u003e:\u003c/b\u003e Uses 'GITHUB_TOKEN' to authenticate with GitHub. This is necessary to push changes to the repository.\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\n3. Commit and push the workflow file to your repository.\n\n4. That's it! The action will run automatically and update your README.\n\n## Frequently Asked Questions\n\n### How do I configure dōteki?\n\nSimply modify `doteki.toml` and the README markers. [See the docs](https://doteki.org/docs/configuration/).\n\nYou don't need to modify the workflow file unless you want to change the schedule, the `doteki-action` version, or the environment variables.\n\n### A plugin needs me to set an environment variable. How do I do that?\n\nIf a plugin is asking you to set an environment variable, it's because it needs to access sensitive information, such as an API key. If you added this information to `doteki.toml`, it would be visible to anyone who can see your repository.\n\nThe solution is to use GitHub's [secrets](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions).\n\nOn your profile repository, go to the \"Settings\" tab and click on \"Secrets and variables\", then \"Actions\".\n\nThere you can create a new repository secret, say, \"lastfm\", and add the value for the variable there:\n\n![Creating a secret](assets/secret.png)\n\nFinally, in your workflow file, add a line at the end of the `steps` section, inside `env`:\n\n```yaml\nenv:\n  DOTEKI_LASTFM_API_KEY: ${{ secrets.lastfm }}\n```\n\n**Note**: The string on the left side is the name of the environment variable that the plugin expects. `secrets.\u003cname\u003e` must match the name of the secret you created.\n\n### Something didn't go as expected. Where can I find logs?\n\nOpen your GitHub profile repository and go to the \"Actions\" tab. There you will find a list of all the workflows that have been run:\n\n![Actions tab](assets/actions_tab.png)\n\nClick on the one you are interested in, and then on the \"update-readme\" job.\n\nThere you can search the logs or open the \"Run dōteki action\" step to see the full logs. For example, if you used an invalid Last.fm API key, you would see:\n\n![Logs showing a lastfm plugin error\"](assets/lastfm_error.png)\n\n### I have a question that is not answered here. What should I do?\n\nDon't hesitate to reach out via the [issue tracker](https://github.com/welpo/doteki-action/issues), [discussions](https://github.com/welpo/doteki-action/discussions), or [email](mailto:osc@osc.garden?subject=[GitHub]%20dōteki-action).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwelpo%2Fdoteki-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwelpo%2Fdoteki-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwelpo%2Fdoteki-action/lists"}