Alfred Confluence Workflow
Search Confluence from Alfred and open results in your browser.
Features
- Search Confluence from Alfred and open results in your browser
- Copy Confluence page URL to clipboard (⌘ + C on an Alfred result)
- Works on M1 and Intel Macs
- Authenticate with your Confluence account via Access Token or Username/Password
- Works for Confluence Enterprise and Confluence Cloud
Usage
- Download the latest version of the workflow here
- Open the workflow in Alfred
- Adjust the environment variables accordingly
- Type
c
in Alfred to search Confluence
Environment variables
BASE_URL
: Confluence base URL without trailing slash e.g. https://confluence.example.comACCESS_TOKEN
: Confluence access token (only for Confluence Enterprise)USERNAME
: Confluence usernamePASSWORD
: Confluence password (or API Token when the cloud version is used, see here)
Authentication
For Cloud Users: In the cloud version you have to use the username/password combination! The username is your Confluence username and the password is an API Token. You can obtain a token here.
You can use either an access token or a username/password combination. You can obtain an access token by following the instructions here. If you use an access token, you can omit the username and password. If you use a username/password combination, you can omit the access token. If you provide both, the access token will be used.
Development
The current development setup assumes that it is built on a Mac with M1.
To do
- include id in results to alfred to ensure learning by selection
- possibility to copy url without opening result
- include "search in confluence" option in results
- fix & strings in results
- readme
- publish
- create release in github
- build for intel chip (universal release?)
- compare to python workflow
- use token based auth
- utf-8 chars not searchable (e.g. "führung")
- add getting started section to readme
Contributing
Contributions are welcome! Please fork the repository and submit a pull request with your changes or open an issue with your suggestions.
Credits
This project is heavily inspired by alfred-confluence which is a Python based workflow for searching Confluence. The mentioned project is not working anymore due to the removal of Python 2 support in macOS 12.3.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.