Using Swivle Agent

Swivle Agent is an application with which files can be automatically opened from Swivle in their native application. After editing them in some way, they can the be saved back to Swivle.

Using Swivle with Swivle Agent makes it possible for you to work on your files without the hassle of managing the file itself. With Swivle Agent, Swivle can automatically open a file in its native application and detect when that file has been edited. This way, a new version can be seamlessly checked back in to Swivle.

Swivle Agent is available for Windows and macOS and needs to be separately installed on your system. Once installed, it runs in the background while working with Swivle.

Note: Editing InDesign files is not done by using Swivle Agent but with a dedicated InDesign plug-in: Swivle for InDesign. For more information, see the articles about working with Swivle for InDesign.

This article describes how to install Swivle Agent.

Downloading

Click one of the download links below to download the latest version of the Swivle Agent:

• For macOS
• For Windows

Installing

Double-click the downloaded file to start the installation and follow the instructions on screen.

Making sure that Swivle Agent is running

After installation, Swivle Agent is automatically started on Windows, but needs to be started manually on macOS.

When Swivle Agent is running, an icon is shown in the notification area (Windows system tray) or in the menu bar (macOS).

Figure: The Swivle Agent icon in the notification area of Windows (left) and in the menu on macOS (right).

Tip: Configure your system in such a way that Swivle Agent is automatically started when the system itself is started.

(Optional) Changing preferences

By default, files that are checked-out are stored in the following location:

• macOS: users/<user folder>/Documents/Swivle Checkouts/<user folder>
• Windows: users\<user folder>\My Documents\Swivle Checkouts\<user folder>

To change this location, do the following:

Step 1. Make sure that Swivle Agent is running.

Step 2. Access the Swivle Agent menu by doing one of the following:

• macOS: Click the icon in the menu bar.
• Windows: Right-click the icon in the notification area (system tray).

Step 3. From the menu, choose Change Checkouts folder.

Step 4. In the dialog that appears, select the folder in which the checked-out files should be stored.

Using Swivle Agent

The next time you log in to Swivle, it will detect if Swivle Agent is running on your machine and will automatically connect to it.

For more information, see Opening files for editing (file check-out and check-in) in Swivle.

Troubleshooting

When Swivle Agent is not working correctly, try the solutions listed below.

Unable to connect to Swivle Agent

For details, see Unable to connect Swivle to Swivle Agent.

Re-connecting Swivle Agent

If Swivle Agent is disconnected from Swivle, the connection can be restored by clicking the icon on the top right in the header when logged in.

Alternatively, close and restart Swivle Agent, and/or log out of Swivle and log in again.

Log file

In case something goes wrong, a log file may need to be sent to support for troubleshooting purposes. This file is stored in the following location:

• macOS: ~/Library/Logs/Swivle Agent/log.log
• Windows: %USERPROFILE%\AppData\Roaming\Swivle Agent\log.log