{"id":17716903,"url":"https://github.com/siddharth2016/quote-readme","last_synced_at":"2025-07-12T13:02:15.779Z","repository":{"id":65155697,"uuid":"301727087","full_name":"siddharth2016/quote-readme","owner":"siddharth2016","description":"A GitHub Action that allows you to place a random quote/fun-fact on your README file, from a collection of famous computer science quotes/facts !","archived":false,"fork":false,"pushed_at":"2024-01-02T04:45:23.000Z","size":338,"stargazers_count":39,"open_issues_count":0,"forks_count":13,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-12T05:03:51.568Z","etag":null,"topics":["dockerfile","github","github-actions","github-actions-docker","hacktoberfest","python","quote-readme","quotes","readme","readme-update","update-quotes"],"latest_commit_sha":null,"homepage":"https://github.com/siddharth2016","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/siddharth2016.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}},"created_at":"2020-10-06T12:58:24.000Z","updated_at":"2025-06-25T23:54:08.000Z","dependencies_parsed_at":"2024-01-02T05:31:46.186Z","dependency_job_id":"b9bfe79c-b469-4f31-9b12-684ae6ab32d9","html_url":"https://github.com/siddharth2016/quote-readme","commit_stats":{"total_commits":54,"total_committers":1,"mean_commits":54.0,"dds":0.0,"last_synced_commit":"51c01f5fcf8574bbf602afb09d5aa1b70725b8bd"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/siddharth2016/quote-readme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharth2016%2Fquote-readme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharth2016%2Fquote-readme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharth2016%2Fquote-readme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharth2016%2Fquote-readme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siddharth2016","download_url":"https://codeload.github.com/siddharth2016/quote-readme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddharth2016%2Fquote-readme/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264995086,"owners_count":23694881,"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":["dockerfile","github","github-actions","github-actions-docker","hacktoberfest","python","quote-readme","quotes","readme","readme-update","update-quotes"],"created_at":"2024-10-25T14:01:13.281Z","updated_at":"2025-07-12T13:02:15.511Z","avatar_url":"https://github.com/siddharth2016.png","language":"Python","funding_links":[],"categories":["🛠️ Widgets 👇"],"sub_categories":[],"readme":"# Random Quote/Fact on README [![Travis CI Build](https://travis-ci.org/siddharth2016/quote-readme.svg?branch=main)](https://travis-ci.org/github/siddharth2016/quote-readme)\n\n\n![Github Socialify](https://socialify.git.ci/siddharth2016/quote-readme/image?font=Source%20Code%20Pro\u0026forks=1\u0026issues=1\u0026pattern=Brick%20Wall\u0026stargazers=1\u0026theme=Dark)\n\n---\n\n## GitHub Action that allows you to place a random quote/fact on your README\n\n![Random Quote On Readme Result](images/result.png)\n\n---\n\n## Random Quote/Fact on your (Profile) Readme\n\n### How To Use This Action\n\nThere is a short tutorial with enough steps for you to get started with this not-so-useful GitHub Action. Check that out [here](https://chandraji.dev/quote-readme-see-wonderful-quotesfun-facts-on-your-github-profile-readme).\n\nIf you want to get an in-depth idea of the usage of this action, please follow the below points.\n\n### Prepare Your Repository\n\n1. You need to update the markdown file(.md) with 2 comments. You can refer to [here](#update-your-readme) for updating it.\n2. **Optional** You'll need a GitHub API Token with `repo` scope from [here](https://github.com/settings/tokens) if you're running the action for a non-profile repository.\n   - You can use [this](#other-repository-not-profile) example to work it out.\n3. You can follow any one example below according to your needs to get started!\n   - Use [this](#profile-repository) on Profile Repository.\n   - Use [this](#other-repository-not-profile) on any other Repository.\n4. It is better to run the Action on your Profile Repository since you won't be needing a GitHub Access Token!\n5. Check [this](#examples) to see available options while creating a workflow for this action.\n\n### Errors And Workarounds\n\nIf you are facing a GithubException \"Resource not accessible by integration\", you may want to check your repository permissions or GitHub token permissions.\n\nFor repository permissions (Thank you [@jaborjkath](https://github.com/jaborjkath) for bringing this to my attention):\nTo enable read and write permissions from the relevant repository settings (top right corner) → Actions (left navigation bar) → General → Workflow permissions section.\nYou can find more information [here](https://stackoverflow.com/questions/61989951/github-action-workflow-not-running/77167633#77167633).\n\nFor GitHub token permissions you can refer [here](https://docs.github.com/en/actions/security-guides/automatic-token-authentication).\n\n---\n\n### Update Your Readme\n\nAdd a comment to your `README.md` like this:\n\n```md\n\u003c!--STARTS_HERE_QUOTE_README--\u003e\n\u003c!--ENDS_HERE_QUOTE_README--\u003e\n```\n\nYou can place these 2 lines anywhere you want quotes/facts to be displayed.\n\n---\n\n### Profile Repository\n\n_If you're executing the workflow on your Profile Repository  (`\u003cusername\u003e/\u003cusername\u003e`)_\n\nYou wouldn't need a GitHub Access Token since GitHub Actions already makes one for you.\n\nPlease follow the steps below:\n\n1. Go to your `\u003cusername\u003e/\u003cusername\u003e/actions`, hit `New workflow`, then `set up a workflow yourself`, delete all the default content github made for you.\n2. Copy the following code and paste it to your new workflow you created at step 1, commit the workflow and name it whatever you like !\n\n```yml\nname: Update Quote Readme\n\non:\n  workflow_dispatch:\n  schedule:\n    # Runs at 2 UTC everyday\n    - cron: \"0 2 * * *\"\n\njobs:\n  update-readme:\n    name: Update Quote README\n    runs-on: ubuntu-latest\n    steps:\n      - uses: siddharth2016/quote-readme@main\n```\n\n3. There is another tag as well you can use, `OPTION` that would allow you to specify what you want either a quote or a fact to be displayed, by default it is `both`. Check [examples](#examples) for more.\n4. Add a comment to your `README.md` like this:\n\n```md\n\u003c!--STARTS_HERE_QUOTE_README--\u003e\n\u003c!--ENDS_HERE_QUOTE_README--\u003e\n```\n\n5. Go to Workflows menu (mentioned in step 1), click `Update Quote Readme`, click `Run workflow`.\n6. Go to your profile page, you will be able to see a random quote/fact wherever you placed [this](#update-your-readme) comment on README.\n\n---\n\n### Other Repository (not Profile)\n\n_If you're executing the workflow on another repo other than (`\u003cusername\u003e/\u003cusername\u003e`)_\n\nYou'll need to get a [GitHub Access Token](https://docs.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token) with a `repo` scope.\n\nYou need to save the GitHub API Token in the repository secrets. You can find that in the Settings of your Repository.\n\n1. Go to your `\u003cusername\u003e/\u003cdifferentrepo\u003e/actions`, hit `New workflow`, then `set up a workflow yourself`, delete all the default content github made for you.\n2. Copy the following code and paste it to your new workflow you created at step 1, commit the workflow with whatever name you like !\n\n```yml\nname: Update Quote Readme\n\non:\n  workflow_dispatch:\n  schedule:\n    # Runs at 2 UTC everyday\n    - cron: \"0 2 * * *\"\n\njobs:\n  update-readme:\n    name: Update Quote README\n    runs-on: ubuntu-latest\n    steps:\n      - uses: siddharth2016/quote-readme@main\n        with:\n          GH_TOKEN: ${{ secrets.GH_TOKEN }}\n          REPOSITORY: \u003cusername\u003e/\u003cdifferentrepo\u003e # No need to mention this if workflow present in current non profile repo.\n```\n\n3. There is another tag as well you can use, `OPTION` that would allow you to specify what you want either a quote or a fact to be displayed, by default it is `both`. Check [examples](#examples) for more.\n4. Add a comment to your `README.md` like this:\n\n```md\n\u003c!--STARTS_HERE_QUOTE_README--\u003e\n\u003c!--ENDS_HERE_QUOTE_README--\u003e\n```\n\n5. Go to Workflows menu (mentioned in step 1), click `Update Quote Readme`, click `Run workflow`.\n6. Go to your profile page, you will be able to see a random quote/fact wherever you placed [this](#update-your-readme) comment on README.\n\n---\n\n### Examples\n\n1. If you want to use this action for a README that is not present in current workflow repository.\n\n```yml\n- uses: siddharth2016/update-readme-image@main\n  with:\n    GH_TOKEN: ${{ secrets.GH_TOKEN }}     # Needed if README repository is not profile repo\n    REPOSITORY: \u003cusername\u003e/\u003cdifferentrepo\u003e\n```\n\nUsing `REPOSITORY` will change README present in that repository head.\n\nFor example, if your workflow is present in `\u003cusername\u003e/repo1` and you want to update README present in `\u003cusername\u003e/repo2`, then assign `REPOSITORY` to `\u003cusername\u003e/repo2` in workflow at `\u003cusername\u003e/repo1`.\n\n2. You can specify a commit message to override the default _\"Update with quote-readme\"_.\n\n```yml\n- uses: siddharth2016/update-readme-image@main\n  with:\n    GH_TOKEN: ${{ secrets.GH_TOKEN }}     # Needed if README repository is not profile repo\n    REPOSITORY: \u003cusername\u003e/\u003cdifferentrepo\u003e  # Needed if README repository is not current repo\n    COMMIT_MESSAGE: \u003cyour-commit-message\u003e       # default - Update with quote-readme\n```\n\n3. You can also choose if you only want either a random `quote` or a random `funfact` to appear on your readme, by default it is `both`.\n\n```yml\n- uses: siddharth2016/update-readme-image@main\n  with:\n    GH_TOKEN: ${{ secrets.GH_TOKEN }}     # Needed if README repository is not profile repo\n    REPOSITORY: \u003cusername\u003e/\u003cdifferentrepo\u003e  # Needed if README repository is not current repo\n    COMMIT_MESSAGE: \u003cyour-commit-message\u003e       # default - Update with quote-readme\n    OPTION: both            # default - both, can be one of (quote, funfact, both), if 'both' then will display either a quote or a fact\n```\n\n---\n\n### Tests\n\nTo run tests simply execute the following in the directory containing `main.py`:\n\n```bash\npython -m unittest discover\n```\n\n---\n\n#### Another intriguing action you would want to use - [update-readme-image](https://github.com/marketplace/actions/update-image-readme)\n\n#### Check out the [scripts](https://github.com/siddharth2016/quote-readme/tree/main/scripts) folder to know more about how quotes/facts were retrieved\n\n#### If you liked this Action and want to contribute to upgrade this utility, please create an issue or throw a PR !\n\n---\n\n#### Inspired From\n\n[athul/waka-readme](https://github.com/athul/waka-readme)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddharth2016%2Fquote-readme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddharth2016%2Fquote-readme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddharth2016%2Fquote-readme/lists"}