{"id":14065142,"url":"https://github.com/brpaz/ulauncher-github","last_synced_at":"2025-08-07T16:13:04.556Z","repository":{"id":37862657,"uuid":"146988580","full_name":"brpaz/ulauncher-github","owner":"brpaz","description":"Ulauncher Extension that provides quick access to common GitHub functionality like your repositories or gists.","archived":true,"fork":false,"pushed_at":"2025-02-12T20:23:14.000Z","size":7230,"stargazers_count":48,"open_issues_count":7,"forks_count":13,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-21T18:02:46.653Z","etag":null,"topics":["github","ulauncher","ulauncher-extension"],"latest_commit_sha":null,"homepage":"https://ext.ulauncher.io/-/github-brpaz-ulauncher-github","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/brpaz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":"brpaz","custom":"https://www.buymeacoffee.com/Z1Bu6asGV"}},"created_at":"2018-09-01T10:18:13.000Z","updated_at":"2025-05-04T21:55:09.000Z","dependencies_parsed_at":"2024-05-27T23:18:32.011Z","dependency_job_id":"6b2c452f-994d-469c-ab08-6cf821adce1d","html_url":"https://github.com/brpaz/ulauncher-github","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/brpaz/ulauncher-github","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fulauncher-github","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fulauncher-github/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fulauncher-github/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fulauncher-github/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brpaz","download_url":"https://codeload.github.com/brpaz/ulauncher-github/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fulauncher-github/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269286266,"owners_count":24391423,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["github","ulauncher","ulauncher-extension"],"created_at":"2024-08-13T07:04:19.649Z","updated_at":"2025-08-07T16:13:04.505Z","avatar_url":"https://github.com/brpaz.png","language":"Python","readme":"# Ulauncher Github\n\n\u003e [ulauncher](https://ulauncher.io/) Extension that provides quick access to common [GitHub](https://github.com) functionality like your repositorie, assigned issues or Pull Requests and many more.\n[![CI Status](https://img.shields.io/github/workflow/status/brpaz/ulauncher-github/CI?color=orange\u0026label=actions\u0026logo=github\u0026logoColor=orange\u0026style=for-the-badge)](https://github.com/brpaz/ulauncher-docker/workflows)\n[![Ulauncher Extension](https://img.shields.io/badge/Ulauncher-Extension-green.svg?style=for-the-badge)](https://ext.ulauncher.io/-/github-brpaz-ulauncher-github)\n![License](https://img.shields.io/github/license/brpaz/ulauncher-github.svg?style=for-the-badge)\n\n## Usage\n\n![demo](demo.gif)\n\n## Features\n\n- Quick access to your repositories and organizations.\n- Access to your Issues and Pull Requests (Assigned, Created)\n- Search public repos and users\n- Search on [GitHub Documentation pages](https://docs.github.com/en)\n\n## Getting started\n\n\n### Pre-Requisites\n\nThis extension requires Python \u003e 3 and a few python packages installed on your system.\n\nTo install them, you can run the following command, on your terminal:\n\n```bash\npip install -r https://github.com/brpaz/ulauncher-github/blob/master/requirements.txt\n```\n\n### Install the extension\n\n\nOpen ulauncher preferences window -\u003e extensions -\u003e add extension and paste the following url:\n\n`https://github.com/brpaz/ulauncher-github`\n\n\n### Extension Settings\n\nBefore being able to start using the extension, you must generate a **Personal Access Token** (PAT) and configure it in the extension settings. The access token will allow the extension to access the GitHub API.\n\nYou can generate yours [here](https://github.com/settings/tokens). Make sure you select at least the permissions for \"repo\", \"read:org\", \"gist\", \"user\" and \"notifications\", otherwise you might see errors when using some specific commands in the extension.\n\n## Usage\n\nThis extension provides various commands/keywords to access the different functionality. If you type `GitHub` in Ulauncher you should see the available commands.\n\n![Extension Screenshot](./assets/screenshots/screenshot_1.png)\n\nThese include:\n\n- GitHub: Search Repositories\n- GitHub: Search Users\n- GitHub: My Gists\n- GitHub: My Organizations\n- GitHub: My Assigned Issues\n- GitHub: My Created Issues\n- GitHub: My Assigned Pull Requests\n- GitHub: My Created Pull Requests\n- GitHub: My Notifications\n- GitHub: My Repositories\n- GitHub: My Account\n- GitHub: Search Documentation\n- GitHub: Extension Options\n\n### Note on Cache\n\nWhen the extension starts, it will download a list of all of your repositories, stars and gists and save them in a `json` file. This helps for performance reasons and GitHub API doesn´t have a way to search on your own and organizations repostories in the same request.\n\nThis information is cached for 1 day by default. You can clear your cache and trigger a reindex of the local data by restarting ulauncher or by going to `GitHub: Extension Options -\u003e Refresh cache`.\n\nDepending on the number of repositories you have access, this indexing process might take some time. It is executed in the background and you will receive a notification when the process finishes.\n\n## Development\n\n```\ngit clone https://github.com/brpaz/ulauncher-github\nmake link\n```\n\nThe ```make link``` will create a symbolic link to the ulauncher extensions folder.\n\nNext, stop Ulauncher if running and run the following command:\n\n```\nmake dev\n```\n\nThis will start Ulauncher from the command line with all extensions disabled. In the output you will see something like this:\n\n```\n VERBOSE=1 ULAUNCHER_WS_API=ws://127.0.0.1:5054/com.github.brpaz.ulauncher-github PYTHONPATH=/usr/lib/python3.8/site-packages /usr/bin/python3 /home/bruno/.local/share/ulauncher/extensions/com.github.brpaz.ulauncher-github/main.py\n```\n\nRun this, command in another terminal window, to laucnh the GitHub Extension.\n\n\n## TODO\n\n- Cache user repositories, gists and organizations in background for faster results.\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n## 💛 Support the project\n\nIf this project was useful to you in some form, I would be glad to have your support.  It will help to keep the project alive and to have more time to work on Open Source.\n\nThe sinplest form of support is to give a ⭐️ to this repo.\n\nYou can also contribute with [GitHub Sponsors](https://github.com/sponsors/brpaz).\n\n[![GitHub Sponsors](https://img.shields.io/badge/GitHub%20Sponsors-Sponsor%20Me-red?style=for-the-badge)](https://github.com/sponsors/brpaz)\n\n\nOr if you prefer a one time donation to the project, you can simple:\n\n\u003ca href=\"https://www.buymeacoffee.com/Z1Bu6asGV\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n## 📝 License\n\nCopyright © 2020 [Bruno Paz](https://github.com/brpaz).\n\nThis project is [MIT](https://opensource.org/licenses/MIT) licensed.\n","funding_links":["https://github.com/sponsors/brpaz","https://www.buymeacoffee.com/Z1Bu6asGV"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrpaz%2Fulauncher-github","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrpaz%2Fulauncher-github","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrpaz%2Fulauncher-github/lists"}