https://github.com/simon04/rofi-confluence-jira
https://github.com/simon04/rofi-confluence-jira
atlassian-confluence atlassian-jira confluence jira rofi
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/simon04/rofi-confluence-jira
- Owner: simon04
- License: gpl-3.0
- Created: 2019-11-28T13:26:55.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T13:40:08.000Z (over 2 years ago)
- Last Synced: 2025-02-12T00:37:57.611Z (4 months ago)
- Topics: atlassian-confluence, atlassian-jira, confluence, jira, rofi
- Language: Python
- Homepage:
- Size: 22.5 KB
- Stars: 1
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rofi-confluence-jira
Loads the most recently modified [Confluence](https://www.atlassian.com/software/confluence) pages and the most recently updated [JIRA](https://www.atlassian.com/software/jira) issues via their REST APIs, and displays those in a [rofi](https://github.com/davatorium/rofi) menu to quickly access them.
## Dependencies
- [Python 3](https://www.python.org/)
- [PyXDG](https://freedesktop.org/wiki/Software/pyxdg/)
- [Requests](https://pypi.org/project/requests/)
- [rofi](https://github.com/davatorium/rofi)
## Installation
Depending on your system you can run, potentially you'd prefer this in a venv - but this would require you to add a wrapper for launching the script.
- For stable requirements: `pip install -r requirements-freeze.txt`
- For newer requirements: `pip install -r requirements.txt`
## Configuration
This script reads the configuration from `"${XDG_CONFIG_HOME:-${HOME}/.config}/rofi-confluence-jira.cfg"`.
```ini
; .config/rofi-confluence-jira.cfg
[confluence]
URL = https://confluence.example.com
USER = username
PASS = password
[jira]
URL = https://jira.example.com
USER = username
PASS = password
```
### Usage API Token
To use an API token instead of your regular password.
1. Retrieve an api token for your instance, if you are using public atlassian the link is: [`https://id.atlassian.com/manage-profile/security/api-tokens`](https://id.atlassian.com/manage-profile/security/api-tokens)
2. Set the token as `PASS` and your username or email address as `USER`
### Different browser
You can set the environment variable `BROWSER` to define a different browser.
`BROWSER=xdg-open ./rofi-confluence-jira.py`
## Author and License
- Author: [simon04](https://github.com/simon04)
- License: [GPL v3](https://github.com/simon04/bldrwnsch/blob/gh-pages/LICENSE)