Help Center

How can we help?

search

Categories

rocket_launch

Getting Started

Installation guide, account setup, and first steps with the desktop app.

chevron_right
payments

Payment & Billing

How customer accounts are charged based on monthly app usage and inactive users.

chevron_right
quiz

FAQs

Common questions about pricing, security, and desktop features.

chevron_right
shield_lock

Security

How we protect sign-in, tokens, and data in transit with the Jira integration.

chevron_right

Getting started

Download and install PTIAS Jira Companion for your platform from the PTIAS website, then open the desktop app. Use Login to create or access your PTIAS account.

Connect Jira. The first time you use the app with Jira, you complete an OAuth flow in your browser (Atlassian's standard authorization). That links your PTIAS profile to your Jira identity so you can search issues, log time, and use reminders on your machine.

Trial. New customers typically start on a trial so your team can use the full product and evaluate it with your real Jira site. When the trial ends, you can move to a paid subscription from your account area on the web so service continues without interruption.

After you are a paying customer, a Customer Admin for your organization can invite Team Leaders and End Users, assign roles, and tune how reminders and policies apply to the team. Reminder defaults and enforcement (for example inactivity or over-logging ranges) can be managed from the web console for the whole organization, while each user still has their own preferences in the desktop app where your policy allows it.

Payment & Billing

Billing is tied to your customer (organization) account, not to each individual user card. In each billing period we align charges with how many users in your organization actually used the app during that month— for example people who opened the desktop client and used it with your Jira data in that calendar month.

Users who were invited or provisioned but did not use the app in that month are not counted toward that period's usage-based charge. In practice that means you are not paying for inactive seats when teammates skip a month entirely.

Invoices, payment method, and subscription details are handled in your account area after you sign in. For questions about a specific invoice or access, use Contact or email contact@ptias.com.

FAQs

Browse by topic. Click a question to show or hide the answer.

Getting started

Installation basics and what this product is.

How do I install and run the desktop app?

Download the installer for your platform from the PTIAS website, run it, then open the app and sign in with your PTIAS account. After sign-in, connect Jira using the OAuth flow (your browser will open for Atlassian). Updates are delivered through the same channel as your installer; follow any in-app prompts when a new version is available.

Is this an official Atlassian product?

We love Jira! But No! - PTIAS Jira Companion is built by PTIAS - not By Atlassian. It works with your Atlassian Jira site using Atlassian-supported OAuth APIs; Atlassian is NOT the publisher of this app.

Security, privacy & your Jira data

How sign-in works and what leaves your device.

How does Jira sign-in work, and do you store my Jira password or tokens on your servers?

Jira access uses OAuth according to Atlassian's recommended patterns. You authorize the app in your browser with Atlassian; we do not ask for your Jira password inside our product for that step.

We do not store your Jira OAuth access or refresh tokens on PTIAS servers. Tokens stay on your device (for example in the operating system's secure storage) so that a compromise of our hosted infrastructure would not, by itself, hand an attacker your Jira API credentials.

We do not copy your Jira issue content to our servers as an application database. Issue summaries, descriptions, comments, attachments, worklogs, and similar data are exchanged between the desktop app and your organization's Jira. For account binding we only retain a small profile snapshot from OAuth (such as your Atlassian account ID, email, and display name). See the Privacy Policy for the full picture.

Main window, system tray & floating widget

How the app behaves when you close the window and how the on-screen reminder works.

What happens when I close the main window?

By default, closing the main window minimizes the app to the system tray (notification area) so reminders and background behavior can continue. Look for the PTIAS icon there to open the window again or quit completely.

In Preferences you can change what the window close (X) button does: for example, keep the default tray behavior, or close the main window and rely on the floating reminder widget instead. Pick the option that matches how you like to work.

How do I change the font size from the main window?

Move the pointer over the main window (for example over the issue table or the top bar), hold Ctrl, and scroll the mouse wheel up or down. That adjusts the app font size in small steps (within the same limits as Preferences), applies it right away, and saves it for your next session.

What is the floating widget, and how does it relate to reminders?

The floating widget is a small on-screen companion (often near the edge of your screen) that supports time-tracking reminders. It can remind you when you have not logged time during the working hours and days you configured, and it works together with inactivity and over-logging reminders in Preferences.

If you dismiss or park the floater during a day when you still have not logged time in the allowed window, it can come back automatically to remind you to log time. Exact behavior depends on your reminder and working-hours settings.

How do I change the floating widget size, color, and transparency?

Hover the floating widget and use your mouse wheel. The app follows this convention (also shown on the widget tooltip):

  • Scroll — resize the widget.
  • Shift + scroll — change color.
  • Ctrl + scroll — change transparency (opacity).

You can also set color and opacity from Preferences if you prefer sliders and previews.

Can I change the reminder sound, and the speed or strength of the floating animation?

Yes. In Preferences, under behavior / reminder settings, you can choose the reminder sound (including built-in options or a custom file where supported), adjust volume, and tune movement (how far the icon shakes) and speed (how fast the shake cycles). These settings only affect your machine.

Reminders & other preferences

Who can change policy, lunch, automatic actions, and appearance.

Who controls reminder settings—the user or the organization?

End users can adjust many reminder and behavior options in their own Preferences (for example inactivity delay, over-logging delay, lunch window, sounds, and floating widget options), subject to what your organization allows.

Customer Administrators can define organization policies from the web console. When a setting is enforced for your organization, the desktop app may show a lock icon next to that control and keep values within the range your admin chose.

What are the inactivity reminder and over-logging reminder?

The inactivity reminder helps when you have been idle for a while but may have forgotten to log time - it prompts you based on a delay you (or your admin) configure.

The over-logging reminder helps when a timer has been running a long time, so you do not accidentally leave work logged against the wrong issue - it reminds you after a configurable number of minutes.

What are automatic actions in Preferences?

Automatic actions let the app stop logging time for Jira items when you're going to lunch or at the end of the working day so those will not run when you're not really working on those Jira items.

How do I set my lunch break in Preferences?

In Preferences under the Behavior tab, find the Working Hours section. Set your usual lunch start and end time (within the same day and within reasonable limits shown in the app). You can optionally enable stopping all timers when lunch begins.

Lunch settings work together with your working hours and working days so reminders know when you expect to be logging time.

How do I change the color theme of the app?

Open Preferences and choose a theme (light, dark, or other bundled styles). The app restyles the main window and dialogs to match; some themes are meant for long work sessions with reduced glare.

I am getting meow / cat sounds all of a sudden!?

You must have set the reminder sound to Cat it out!, but you can change that by going to the Preferences window > Behavior tab and then select the default system sound or any custom sound file that you want to use.

Main table, time tracking & worklogs

Columns, sorting, the time chart, My Worklog, and worklog comments.

How do I add or remove columns in the main table?

Open Preferences and edit the list of Jira fields shown in the main window. Add fields you care about (for example Status, Assignee, or Time spent) and remove ones you do not need. When you save, the table refreshes to match; running timers are preserved where possible. You can also right-click a column header for a shortcut menu: add a column or field (opens Preferences), set text alignment for that column, remove that column, or remove similar or empty columns in one step.

How do I sort or align columns in the main table?

Click a column header to sort by that column (toggle ascending and descending where supported). You can drag column headers to reorder columns.

For text alignment (left, center, right) per column, right-click the column header and choose Align Left, Align Center, or Align Right. You can also use the alignment controls in Preferences so numbers and labels line up the way you prefer.

What is the small chart icon next to an issue key?

That icon opens the Time tracking view for that specific issue: a popup window with a chart of time logged over the life of the Jira issue so you can compare the estimated with the spent time to see patterns without leaving the app.

What is the “My Worklog” window?

My Worklog summarizes how much time you logged as worklogs: totals for today, yesterday, the last N days, and a custom date range (based on the issues currently loaded in your table). Use Show in table to add the Time spent field and narrow JQL to your worklogs; use export or copy actions if you need the numbers elsewhere.

What is the default worklog comment, and how do comments work when starting or stopping a timer?

Jira stores a worklog comment separately from issue comments. In Preferences you can enable a default worklog comment text that is applied when you log time (when that option is on).

You can also require or optionally prompt for a comment when you start a timer and/or when you stop it (optional vs mandatory modes). That helps teams that need every worklog entry to carry a short explanation.

Exports

CSV vs Excel with analysis.

What is the difference between Export to CSV and Export with analysis (Excel)?

Export to CSV writes the current table—headers and cell values—to a .csv file. The special Action column (start/stop controls) is omitted because it is not meaningful in a file. This format opens in Excel, Google Sheets, or any text editor.

Export with analysis (Excel) builds an .xlsx workbook. It includes your table data on a Data sheet plus extra columns derived from Jira relationships and time fields (for example parent and grand-parent keys, rollups, and percentage-style comparisons where configured). A second Parents sheet lists parent keys for hierarchy-style reporting. Use CSV for a simple dump; use Excel when you want the enriched analysis layout.

Billing & account

Where is billing handled?

Subscription and payment questions are handled in your account area after you sign in on the web. For invoice or access issues, email contact@ptias.com or use the Contact page.

Security

Jira access. The desktop app connects to your Atlassian Jira site using OAuth in line with Atlassian's recommended integration model. You approve access in the browser; we do not collect your Jira password inside the product for that step.

Tokens. Your Jira OAuth access and refresh tokens are not stored on PTIAS servers. They remain on your device (for example in the operating system's secure storage) with Atlassian as part of the normal OAuth flow. A compromise of our hosted services would not, by itself, expose those credentials for someone to take over your Jira account from our infrastructure.

Jira content. Issue summaries, descriptions, comments, worklogs, and similar ticket data are not uploaded to PTIAS as an application database. That data moves between the desktop app and your organization's Jira over your existing channel to Atlassian. PTIAS only retains a small profile snapshot from OAuth for account binding (such as Atlassian account ID, email, and display name), as described in the Privacy Policy.

support_agent

Still need help?

Our support team is available Monday to Friday to help with technical issues and account questions.

mailContact Supportcontact@ptias.com
Help Center — PTIAS Jira Companion | PTIAS Jira Companion