Skip to content

A Stream Deck plugin for finding issues in Jira or content in Confluence

License

Notifications You must be signed in to change notification settings

mediabounds/streamdeck-jira

Repository files navigation

Stream Deck Jira Plugin

Jira on Stream Deck A Stream Deck plugin for finding issues in Jira or content in Confluence.

For example, add an action showing the number of Jira issues matching a JQL query (i.e. the number of new issues or issues waiting for your feedback). Or, add an action showing the number of inline Confluence tasks assigned to you.

Features

  • Allows for multiple actions to be defined with different JQL queries
  • Search Confluence to find content matching a CQL query
  • Display the number of inline tasks assigned to you in Confluence
  • Button icon shows the count of items matching the query
  • Many customization options for how the badge is displayed
  • Allows for custom icons to be set
  • Supports Jira Cloud and Jira Server (8.14 and later)

Installation

Preferred: Stream Deck Store

https://apps.elgato.com/plugins/com.mediabounds.streamdeck.jira

Alternative: Manual installation

  1. Download the latest release from https://github.com/mediabounds/streamdeck-jira/releases.
  2. Go to your download folder and open com.mediabounds.streamdeck.jira.streamDeckPlugin.

Configuration

JQL Result

  • JQL -- a query for filtering a list of issues.

Confluence Search

  • CQL -- a query written in CQL (Confluence Query Language) for finding a list of matching content.

Confluence Tasks

  • Due After -- finds inline tasks due on or after this date.
  • Due Before -- finds inline tasks due before this date.

Common Settings

Authentication

  • Domain -- the product URL for your Jira organization (i.e. organization.atlassian.net)
  • Type -- whether your Jira instance is Jira Cloud or Jira Server
  • Email -- the email address for your Atlassian account
  • API Token -- an API token for your account

Icon

Optionally, you may also customize how the icon is badged with the number of issues matching the JQL query.

FAQ

Can I choose my own icon?

Yep! But you'll want to upload a Custom Image in the Icon settings for the plugin instead of setting the icon through Streamdeck's icon library.

Setting a Custom Icon

Note
When a custom icon is set using Streamdeck's built-in interface or icon library, the plugin will no longer be able to add a badge on the icon. You can remove a custom icon set via Streamdeck by tapping the ˅ on the icon and selecting Reset to Default.

Why do I get a yellow ! on the icon?

The yellow exclamation mark means that the plugin encountered some problem while trying to find the number of issues matching the JQL query. This could mean the API token isn't entered correctly, or there's a syntax error in the JQL, or just that there was some Internet connection problem while talking to the server.

Below the JQL field is a status indicator that'll confirm whether the plugin is able to communicate with Jira. When there is a problem, it will show a warning. Status indicator

When you click on the status indicator, it will provide more details about what went wrong. Problem message

Need to debug more? If you're sure all the configuration is correct but the connection is still not successful, you can alternate click (i.e. right-clicking) on the status message to get a more in-depth view at the response.

Debugging a problem

License

The plugin is available as open source under the terms of the MIT License. A copy of the license can be found at https://github.com/mediabounds/streamdeck-jira/blob/main/LICENSE.md.