{"id":17017429,"url":"https://github.com/kaustubhgupta/readme-projects-display","last_synced_at":"2025-04-12T09:37:26.344Z","repository":{"id":46575133,"uuid":"351127472","full_name":"kaustubhgupta/readme-projects-display","owner":"kaustubhgupta","description":"🔥 Display your projects information on your profile README","archived":false,"fork":false,"pushed_at":"2021-10-15T13:25:20.000Z","size":158,"stargazers_count":15,"open_issues_count":3,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T04:34:39.837Z","etag":null,"topics":["github-actions","github-api","hacktoberfest","profile-readme","project","project-management","pygithub","pygithub-examples","python","readme"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/readme-projects-display","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/kaustubhgupta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-24T15:18:51.000Z","updated_at":"2024-09-03T02:26:10.000Z","dependencies_parsed_at":"2023-01-11T17:22:54.803Z","dependency_job_id":null,"html_url":"https://github.com/kaustubhgupta/readme-projects-display","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaustubhgupta%2Freadme-projects-display","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaustubhgupta%2Freadme-projects-display/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaustubhgupta%2Freadme-projects-display/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaustubhgupta%2Freadme-projects-display/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaustubhgupta","download_url":"https://codeload.github.com/kaustubhgupta/readme-projects-display/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248547322,"owners_count":21122490,"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":["github-actions","github-api","hacktoberfest","profile-readme","project","project-management","pygithub","pygithub-examples","python","readme"],"created_at":"2024-10-14T06:36:36.968Z","updated_at":"2025-04-12T09:37:26.310Z","avatar_url":"https://github.com/kaustubhgupta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![readme-projects-display](https://socialify.git.ci/kaustubhgupta/readme-projects-display/image?description=1\u0026font=KoHo\u0026forks=1\u0026issues=1\u0026language=1\u0026owner=1\u0026pattern=Floating%20Cogs\u0026pulls=1\u0026stargazers=1\u0026theme=Light) \n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/python%20-%2314354C.svg?\u0026style=for-the-badge\u0026logo=python\u0026logoColor=white\" align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/markdown-%23000000.svg?\u0026style=for-the-badge\u0026logo=markdown\u0026logoColor=white\" align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/github%20actions%20-%232671E5.svg?\u0026style=for-the-badge\u0026logo=github%20actions\u0026logoColor=white \"align=\"center\"\u003e\n\u003c/p\u003e\n\nGitHub's Profile readme is a great tool to showcase your skills and projects to potential recruiters/developers. This GitHub action allows you to update a particular section of README with your Project details. These include the project name, stars, and a controllable amount of description. \n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./images/preview.png\" align=\"center\"\u003e\n\u003c/p\u003e\n\n## Getting Your Profile Ready\n\n- Add this comment in your README.md/specified file:\n```\n\u003c!-- PROJECTS START --\u003e\n\u003c!-- PROJECTS END --\u003e\n```\n\n- The repositories need to have `project` topics to add them to the project section.\n\n- A GitHub personal access token will be needed which can be obtained by going to Settings \u003e Developer Settings \u003e Personal Access Tokens.\n  \u003cdiv align=\"center\"\u003e \u003cimg src=\"./images/config.png\" align=\"center\"\u003e \u003c/div\u003e\n\n_Note: If you give personal repositories access then they will be added to the sections but their links will not work for others_\n\n\n## Action Setup\n\nGitHub actions can be integrated into any repository. Create a new folder called `.github/workflows/\u003cany-name\u003e.yml`. Paste the following starter code:\n\n```yml\nname: Update Projects\non:\n  schedule:\n    - cron: '0 0 * * *'\n    # This makes the action run at the end of every day. Customize this accordingly or you can also trigger this action for GitHub events (Pull, Push). Check the GitHub actions page for that.\n  workflow_dispatch:\n    # workflow_dispatch allows you to trigger the action any time manually\n\njobs:\n  update-readme-with-projects:\n    name: Update this repo's README with latest project updates\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v2\n      - uses: kaustubhgupta/readme-projects-display@master\n        with:\n          gh_token: ${{ secrets.TOKEN }} # Create a secret to store the access token \n```\n\n## Available Options\n\n| Option         | Default Value | Description                                                                  | Required | Example |\n| -------------- | ------------- | ---------------------------------------------------------------------------- | -------- | ------- |\n| `gh_token`     | NA            | GitHub Personal Access token                                                 | Yes      |  NA     |\n| `file_name`        | `README.md`           | Name of the readme file or any other file containing the comment mentioned above. Note: The file needs to be at the root of the repository. (Dynamic paths coming in next version!)                                   | No       |  myfile.txt/ myfile.html    | \n| `max_repo_description` | 50 | How much description you want to Display | No | 40 |\n| `allow_forks` | True | Control if you want to display the number of forks of the repository | No | False |\n| `project_sort_by` | `stars` | Control the sorting of projects by `'stars'` or `'forks'` | No | `'forks'` | \n\n## Examples\n- [My Workflow File](https://github.com/kaustubhgupta/kaustubhgupta/blob/master/.github/workflows/project-updater.yml)\n\n**Happy?? Do Star ⭐ this Repo. 🤩**\n\n## License\n\n[![MIT Licence](https://img.shields.io/github/license/kaustubhgupta/PortfolioFy)](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaustubhgupta%2Freadme-projects-display","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaustubhgupta%2Freadme-projects-display","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaustubhgupta%2Freadme-projects-display/lists"}