Frequently Asked Questions

I tried to launch the application but my operating system won’t let me.

You can ignore your operating system’s warnings and run Cosma, provided you download the application from our GitHub repository, the only official source. To override system warnings, you must have administrator privileges on your session. On macOS, right-click the application then select Open (you may have to do it twice).

Explanation: Windows and macOS require that the code of an application be “signed” in order to trust it automatically. This is done by obtaining a certificate. The process is technically trivial, but is not free, because there is a lot at stake. Indeed, if an application is not signed, the system displays an alert and asks the user to confirm his intentions. Faced with this, many users prefer caution and give up. It is therefore in the best interest of application providers to sign their application so that it can be used. But the case of Cosma is particular: it is experimental research software, only recently made public, and with no dedicated funding. The application is therefore not signed.

I tried creating a record but the application responds with a cryptic error.

You probably did not set a records directory in Preferences. Cosma needs to know where to create records.

The issue is solved in version 1.1.

I created a record with the same name as an existing one, and the old one is gone!

This bug was reported to us after the release of version 1.0. Download version 1.1, which solves the problem.

Don’t forget to backup your data, either by making copies at regular intervals or by using a version control system such as git.

No. Using unique identifiers reduces the risk of dead links without requiring automated maintenance. We feel very strongly about this choice. We mention this in the Unique identifiers section in the docs.

Cosma allows you to replace the 14-digit identifiers by an arbitrary string in the output (cosmoscope). In the demo, we chose to replace them with a simple arrow (→) but you could use a pointing hand (☞) or any other Unicode string. In Cosma, click on Preferences and enter the substitute character(s) in Link Symbol.

Is it possible to manage multiple directories?

We plan to make this easily possible via a dedicated menu in a future update. In the meantime, it is technically possible to do it by following the suggestions below.

Method 1: History

This method is based on the history. It works well for cosmoscopes that you do not intend to modify, and with automatic history disabled.

Imagine you have two directories, dir1 and dir2:

You can now switch between cosmoscopes by clicking on View History, select the desired history entry, Open.

Method 2: `config.json

This method requires manual juggling of configuration files.

Locate the directory containing the files necessary for the proper functioning of the Cosma application (hereafter referred to as the “support directory”). This depends on the operating system:

In this directory you will find a config.json file. This is where Cosma stores and retrieves the configuration.

Again, imagine you have two directories, dir1 and dir2:

You can now switch to a specific directory by copying the corresponding config.json file to the support directory. Update the Cosma display by clicking on New Cosmoscope.

Do you plan to release the GUI version for Linux?

We do not currently provide the GUI version for Linux but we hope to do so soon. Cosma is an Electron-based application, meaning it can be developed for several platforms simultaneously from a single code base. We recently got access to Linux machines to test Cosma on. If this is something you’d like to help us with, please get in touch!

In the meantime, the command line version is available for all platforms. More information here.

Do you have a roadmap?

Yes!

Is the app still being developed/maintained?

Currently, we are in maintenance mode: we keep track of issues and release fixes; the development of new features is on hold. This is because Arthur is busy writing his PhD dissertation and Guillaume has professional engagements which take priority over Cosma. This section will be updated when we get back to active development.