{"id":29420242,"url":"https://github.com/phil91/jihub","last_synced_at":"2026-05-19T09:05:04.328Z","repository":{"id":165702373,"uuid":"641109283","full_name":"Phil91/jihub","owner":"Phil91","description":"Command Tool to help exporting Issues from Jira and import them as GitHub Issues","archived":false,"fork":false,"pushed_at":"2024-01-30T06:26:02.000Z","size":82,"stargazers_count":2,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-01-30T10:34:19.290Z","etag":null,"topics":["dotnetcore","exporter","github-issues","import","jira"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Phil91.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":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null}},"created_at":"2023-05-15T19:53:01.000Z","updated_at":"2024-01-30T10:34:19.291Z","dependencies_parsed_at":"2024-01-29T10:01:52.474Z","dependency_job_id":null,"html_url":"https://github.com/Phil91/jihub","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Phil91/jihub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Phil91%2Fjihub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Phil91%2Fjihub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Phil91%2Fjihub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Phil91%2Fjihub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Phil91","download_url":"https://codeload.github.com/Phil91/jihub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Phil91%2Fjihub/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264923080,"owners_count":23683716,"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":["dotnetcore","exporter","github-issues","import","jira"],"created_at":"2025-07-12T01:30:16.630Z","updated_at":"2026-05-19T09:04:59.289Z","avatar_url":"https://github.com/Phil91.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stars][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![Apache-2.0 License][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ch3 align=\"center\"\u003ejihub\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Command Line Tool to help exporting Issues and Attachments from Jira and import them as GitHub Issues\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/phil91/jihub/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/phil91/jihub/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n  * [About The Project](#about-the-project)\n  * [Getting Started](#getting-started)\n    * [Prerequisites](#prerequisites)\n    * [Setup](#setup)\n  * [Usage](#usage)\n    * [Create you Jira search query](#create-you-jira-search-query)\n    * [Execute Jihub](#execute-jihub)\n  * [Roadmap](#roadmap)\n  * [Known Limitations](#known-limitations)\n  * [Contributing](#contributing)\n  * [License](#license)\n  * [Contact](#contact)\n\u003c/details\u003e\n\n## About The Project\n\n`Jihub` is a sophisticated tool designed to streamline the process of importing Jira issues into GitHub based on specific search queries. With `Jihub`, you can seamlessly convert Jira issues into GitHub Issues, ensuring a smooth transition and preserving vital information such as labels, fix versions, and attachments.\n\nAdditionally, `Jihub` offers an optional feature to export Jira attachments directly to a designated GitHub repository, further enhancing collaboration and consolidating project resources.\n\nFor detailed instructions on how to utilize `Jihub` effectively, please refer to the [Usage](#usage) section. Experience the convenience and efficiency of effortlessly migrating your Jira issues to GitHub with `Jihub`.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Getting Started\n\nTo start using `Jihub`, please follow the steps below.\n\n### Prerequisites\n\nBefore executing `Jihub`, make sure you have the following prerequisites:\n\n- A GitHub Personal Access Token (PAT) for authentication.\n- Write access to the github repository you want to import the issues to\n- Valid login credentials for a publicly accessible Jira instance.\n- OPTIONAL: If you want to export the jira attachments you need write access to the repository you want to import the attachments to.\n\n### Setup\n\nTo setup `Jihub`, just follow these steps:\n\n1. Download the release package of your choice.\n2. Within the package, locate the specific zip file for your operating system. For example, if you're using macOS, select `jihub-osx64.zip`.\n3. Alternatively, you can download the latest build artifact from the [Actions](https://github.com/Phil91/jihub/actions) section. On the left side, select the Build action and download the artifact that matches your operating system.\n4. Unzip jihub and navigate into the unziped folder.\n5. Open the appsettings.json with an editor of your choice and fill the following fields\n\n| Configuration      | Key                  | Value          |\n|--------------------|----------------------|----------------|\n| Jira               | JiraInstanceUrl      | The url of your jira instance, e.g. https://example-jira.com/                |\n|                    | JiraUser             | Your jira username                |\n|                    | JiraPassword         | Your jira password               |\n| GitHub             | Token                | Your generated GitHub PAT               |\n| Parsers:Jira       | EmailMappings        | Mapping between JiraEmail and Github Name, should be in the following format: { \"JiraMail\": \"test.mail.com\", \"GithubName\": \"Phil91\" }               |\n| Parsers:Jira       | DescriptionTemplate  | Template for the Github description. Valid values currently: Description, Components, Sprints, FixVersions, StoryPoints, Attachments please make sure that those values are listed within {{}}               |\n\n\nBy following these steps, you'll be able to use `Jihub` for importing Jira issues to GitHub.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Usage\n\n### Create you Jira search query\n\nIn your Jira Instance, navigate to `/issues`, for example: https://your-jira-instance.com/issues.\nYou can filter for the issues of your needs. After your search result is as wanted, click the Advanced Link right next to the serach button to be able to see your jql query. Copy the query and URL encode it (there are plenty of sites doing it on the fly online).\n\n### Execute Jihub\n\nOnce you completed the setup open a terminal and navigate to your jihub folder. To run the import simply run:\n\n```shell\ndotnet jihub.Worker.dll\n```\n\n\n| Parameter          | Short Name | Long Name       | Required | Default | Description                                                                                |\n|--------------------|------------|-----------------|----------|---------|--------------------------------------------------------------------------------------------|\n| Repo               | -r         | --repo          | Yes      |         | Name of the GitHub repository                                                             |\n| Owner              | -o         | --owner         | Yes      |         | Username of the GitHub user or organization that hosts the project                         |\n| SearchQuery        | -q         | --query         | Yes      |         | The search query to filter Jira issues, must be url encoded                                                    |\n| MaxResults         | -m         | --max-results   | No       | 1000    | The maximum number of Jira results to retrieve                                             |\n| Link               | -l         | --link          | No       | false   | If set, all external resources such as images will be referred to as a link in the description |\n| ContentLink        | -c         | --content-link  | No       | false   | If set, all external resources such as images will be linked as content in the description |\n| Export             | -e         | --export        | No       | false   | If set, all external resources such as images will be exported to the given repository     |\n| UploadRepo         | -u         | --upload-repo   | No       |         | The repository where the Jira assets will be uploaded                                      |\n| ImportOwner        | -i         | --import-owner  | No       |         | The owner of the repository where the Jira assets should be uploaded                       |\n| ImportPath         | -p         | --import-path   | No       |         | The path of the directory where the Jira assets should be uploaded                       |\n\nPlease note that the \"Required\" column indicates whether a parameter is mandatory or not, and the \"Default\" column shows the default value if not specified.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Roadmap\n\n- [ ] Export to various providers\n- [ ] Make configuration easier\n- [ ] Enhance Logging\n- [ ] Make fields to export to github issues configurable\n\nSee the [open issues](https://github.com/phil91/jihub/issues) for a full list of proposed features (and known issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Known Limitations\n\nDue to GitHub Api limitations the import of the issues to GitHub will pause for 20 seconds after 10 created issues before continuing with the next 10.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\nFor further information on how to contribute, take a look at [Contributing](https://www.github.com/phil91/jihub/CONTRIBUTING.md)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## License\n\nDistributed under the Apache-2.0 License. See [LICENSE](https://www.github.com/phil91/jihub/LICENSE) for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## Contact\n\nFeel free to always open a dicussion, or hit me up on LinkedIn\n\nProject Link: [https://github.com/phil91/jihub](https://github.com/phil91/jihub)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/phil91/jihub.svg?style=for-the-badge\n[contributors-url]: https://github.com/phil91/jihub/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/phil91/jihub.svg?style=for-the-badge\n[forks-url]: https://github.com/phil91/jihub/network/members\n[stars-shield]: https://img.shields.io/github/stars/phil91/jihub.svg?style=for-the-badge\n[stars-url]: https://github.com/phil91/jihub/stargazers\n[issues-shield]: https://img.shields.io/github/issues/phil91/jihub.svg?style=for-the-badge\n[issues-url]: https://github.com/phil91/jihub/issues\n[license-shield]: https://img.shields.io/github/license/phil91/jihub.svg?style=for-the-badge\n[license-url]: https://github.com/phil91/jihub/blob/master/LICENSE\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/phils91\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphil91%2Fjihub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphil91%2Fjihub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphil91%2Fjihub/lists"}