Desktop App Options
Last updated
Was this helpful?
Last updated
Was this helpful?
The Copia Desktop application has a number of additional settings that can be adjusted by users. The page will describe each of them, as well as provide recommendations for which settings to enable if applicable.
You can find your Desktop App Options by clicking File > Options. This should open a window like the one seen below. The Options are grouped by category on the left side.
There are two types of Copia accounts. The most common type is a standard Copia account that uses Copia to host your repositories. If your account falls into this category, you should use the Sign In button beneath app.copia.io. If you are a customer using Copia in a Self-Hosted environment, you should use the Sign In button beneath Copia Enterprise.
The Copia Desktop app can sometimes need to interact with external 3rd-party applications, such as resolving merge conflicts in text files or executing Git commands in a command line interface.
This options sets the default application to use when opening text files from the Copia Desktop App. We recommend that you set it to your preferred text editor, whether that be Notepad++, Visual Studio Code, or even just the standard Notepad application that ships with Windows.
This option sets the default shell application that Copia will open when required, such as when you need to run Git commands. You can use your preferred application for this option, but for the majority of Copia users we recommend that you set it to use Command Prompt.
This section of Options is related to how Copia manages Git on your local computer.
This section is for entering the username and password that you want associated with your Git history. While this doesn't technically need to match your Copia username and email, we strongly recommend that you match them.
Copia will use the value of this option when creating a new local repository. When creating new repositories from scratch in the Copia Web App, new repos will always be created with the default branch main.
The section allows you to modify the appearance of your Copia Desktop App. It allows you change the brightness, contrast, and preferring bold-text.
The Copia Desktop App gives prompts when users perform actions that may be irreversible or otherwise potentially dangerous. For new users to Copia and Git, we recommend that you enable all of these options as they can help prevent you from making mistakes.
The Copia Desktop App has the ability to detect when it's been a while since you've committed local file changes or have pushed local commits with Commit & Push Reminders. These reminders only apply to your active repository. These notifications appear as native Windows notifications and therefore appear in the Notifications History area of Windows and are affected by Do Not Disturb settings.
This feature is opt-in and needs to be enabled by navigating to File > Options > Prompts. To enable it, click on the Frequency dropdown bar and selecting the frequency you prefer. You have the choice to select Never (Disabled), 15 minutes, 30 minutes, 1 hour, or 4 hours. After selecting the frequency, click Save to save your preferences.
Commit Reminders
The Copia Desktop App will send you a commit reminder when your Copia desktop app is open and active, there are one or more uncommitted changes for your active repository, and it the configured time period has expired. As shown in the image below, the notification has two buttons that you can select.
Snooze for XX minutes/hours
The Snooze button will delay your notification for your pre-configured delay period. Clicking the Snooze button will also bring the Copia Desktop App back into focus.
Commit Now
The Commit Now button does not actually perform a commit action. Instead, it will bring the Copia Desktop App into focus and will move your cursor to the commit message field so you can immediately start typing your commit message before commiting.
Push Reminders
The Copia Desktop App will send you a push reminder when your Copia desktop app is open and active, there are one or more local, unpushed commits for your active repository, and it the configured time period has expired. As shown in the image below, the notification has two buttons that you can select.
Snooze for XX minutes/hours
The Snooze button will delay your notification for your pre-configured delay period. Clicking the Snooze button will also bring the Copia Desktop App back into focus.
Open Copia
The Open Copia button does not actually perform a push action. Instead, it will bring the Copia Desktop App into focus where you can then perform your push action as described in this section of our Documentation: Pushing
This section includes options for advanced users and for those options that don't fall into the other categories.
This setting dictates the behavior Copia should have when switching branches when you have uncommitted changes. The safest option for avoiding losing your work is "Ask me where I want the changes to go".
Enabling this feature periodically (every 15 minutes) performs a Fetch operation on all on your repositories. This can be useful in case you forget to Fetch before working in a repository. We recommend that you have this option enabled, but you should still get in the habit of fetching prior to working on your repository.
This enables the Auto-Archive feature and is discussed in detail in .
