Files.com Desktop App
Extends your Mac or Windows PC with a Files.com drive so you can open and save files in any app.
Your new Files.com drive will show up in the Mac Finder or Windows File Explorer just like a local volume. You'll get a new Files.com icon that you can click to monitor your connections and status in the Mac menu bar / Windows system tray.
Integrated File locking ensures that multiple users can operate simultaneously on the same office documents.
Click the Files.com pinwheel icon (in your Mac menu bar or Windows system tray) and select the "Sign In To Account" menu option.
In the newly opened web browser window, enter the login details for the Files.com user account with which you would like to connect (just as you would when logging into the web app).
After you've logged in, you'll see a success message in the browser, followed shortly thereafter by a desktop notification informing you that the volume is mounted.
Close the browser window that was triggered by the desktop app and begin using the desktop app.
First, make sure that your user has the proper permissions to use the Desktop app. This is enabled by default for most sites (though Site Administrators can turn this off).
If you're unable to log in, you may need to contact your Files.com site administrator, and request that they enable access through the web app's settings (Settings > Users > Edit > Privileges > Protocol access).
The Files.com desktop app exclusively uses port 443 (HTTPS) for outbound communication, and should operate behind most corporate firewalls.
Once you've signed in, an account will immediately connect, and will automatically connect again every time the app is restarted.
A successfully connected account will be designated by a green icon, and a failed connection will show a yellow indicator.
You can use an account's context menu to manually disconnect that account, after which it will no longer attempt to connect until you've manually connected using this same context menu.
A disconnected account will remain an authenticated bookmark that's ready to reconnect on command.
You can also delete an account from that account's context menu. This will completely remove the bookmarked account along with its credentials (that is, the account's associated desktop app API key).
Of course, you can always sign in to that account again and reconnect at anytime.
You can select Show in Finder (Mac) / Show (Windows) from an account's context menu to quickly view that mounted volume in the Finder (Mac) / File Explorer (Windows).
If an account has expired credentials, you will be required to sign in to that account (through the desktop app) again before reconnecting. Credentials may expire for a number of reasons, including:
- The Desktop session was manually revoked by you or a site administrator via the web app.
- The Desktop session lifetime that's set for your Files.com site has lapsed (defaults to 30 days, unless modified by a site admin).
- Your Files.com site has Desktop Session IP Pinning enabled, requiring you to sign in again if your IP address changes while already signed in to the desktop app.
Administrators can change the settings by referencing the screenshot above.
There are 5 categories of preferences you can set for the Desktop App.
Click on the Files.com icon in the menu bar (Mac) / system tray (Windows), and select Preferences.
Here you'll find six tabbed categories, including:
This tab refers to a feature we built that allows storing file contents in an Offline mode for use when your computer isn't online. Unfortunately, this feature has led to many support problems and we no longer recommend using it. We intend to remove it from a future release. Please ensure that the "Connect Mode" setting here says "Online" and all other options under "Connect Mode" are disabled.
If your use case involves syncing files to a local machine, we instead recommend using the Files.com Command Line Interface (CLI) App for this.
Locking: Enable this setting to prevent conflicting edits when accessing documents from a shared environment.
Mount Location: Change the location of where volumes are mounted.
Cache: This setting is applicable to the connect mode "Smart Synchronization". Do not use this setting as it can cause performance and reliability issues.
Depending on which notifications you want, you can enable or disable notifications for certain events. If the notification setting is enabled for any event such as Upload complete, you will see a notification on your screen when files are uploaded etc. Note that, the notifications should also be enabled at your corresponding Operating System settings or notifications preferences.
Limit the amount of bandwidth that can be used for downloading and uploading files. This setting may be useful if you find that other apps are suffering from reduced performance while transferring large files.
From the dropdown, you can choose which build you'd like to update to. In general, we recommend that users stick to the default, "Release" build, for a more reliable experience. Although if there's a specific feature or bug fix that you're waiting for, it can be useful to temporarily update to an experimental build (with the knowledge that this build may or may not be stable).
After the correct build is selected, you can use the "Check for Update Now" button to manually check for — and download — the latest version of that build.
With the "Automatically check for updates" option enabled, you'll automatically receive an alert when a new version is available for download.
Use the dropdown to change the language that's used by the desktop app interface. By default, it will use the computer system's language preference.
This setting refers to how your Files.com desktop app is launched after you login to your Operating System. Enabling this setting will launch the desktop app automatically when you login to your PC or Mac. We recommend keeping this setting ON always.
You can manage your Files.com documents from the Finder (Mac) / File Explorer (Windows), just as you would any other file or folder that is already on your local machine. Create, open, edit, delete, or move files and folders. You can even drag and drop them from your mounted volume to another folder on your local machine, and vice versa.
Whenever you make a change to your mounted volume, the Files.com desktop app will push those updates to Files.com, keeping your local volume in sync with the remote server.
The image below shows a demonstration.
On the left, you'll notice that your Files.com site stays in-sync on the web app, as you make changes in the desktop app, and vice versa.
On the right, you'll see the interaction between a mounted Files.com drive and a local directory (copying files across both folders on a Mac, via the Finder).
And finally, a file on the mounted Files.com drive is opened on the computer, as you'd expect.
The only difference you'll notice about your Files.com documents is that they'll have a sync-status icon and a context menu that are specific to the Files.com desktop app.
Every file and folder in your mounted volume will have a status icon, indicating its sync status.
There are six different statuses, each with their own icon, described in the table below:
Up to Date. This icon indicates that an incorrect setting has been applied that resulted in the file being downloaded to your local disk. We strongly advise changing your Sync status to the default Online mode and disabling the cache to avoid performance and stability issues.
In Sync. This icon indicates that an incorrect setting has been applied that resulted in the file being downloaded to your local disk. We strongly advise changing your Sync status to the default Online mode and disabling the cache to avoid performance and stability issues.
Online Only. The file can only be opened when a connection to your Files.com site is active. The file does not take any disk space on your computer. The file is downloaded on demand when you open it.
Sync in Progress. The file or directory is currently being synced with your Files.com site.
Sync Error. There was an error updating the file after changes. You are missing permission to write to the file or another problem occurred. Please contact your site administrator for assistance, or contact our Customer Success team. To resolve the error, move the file to your local disk and reload the directory.
Ignored. The file is only saved in a local temporary location and never synced to your Files.com site.
Every file and folder in your mounted volume will have a Files.com context menu, with desktop-app-specific actions that you can take. There are a few ways to access this context menu:
- Right click or control-click on the file or folder that you'd like to take action on.
- Right click or control-click on empty space that's inside the current directory view in the Finder (Mac) / File Explorer (Windows).
- On Mac, use the Finder's toolbar to take action on the current directory view.
The context menu includes a number of different actions, as described below:
If you're on a Mac, you can select "Reload" to manually pull down any unsynced changes that might have occurred on your Files.com site since the desktop app last synced.
On Windows, with the target directory focused in the File Explorer, you can press F5 on your keyboard to pull down updates.
This action should not be used, as it is buggy and can cause performance and reliability issues.
Sets the document (that is, the document that you're taking action on) to "Online" mode, overriding your global sync mode preference for this specific document.
When selected, the desktop app will immediately push any unsynced changes you've made up to your Files.com site, and will then delete the copy from your local disk, giving you online-only access to this document.
Select this to conveniently copy the URL of the folder or file, which you could then paste into a browser to access that item from the web app (assuming you're logged in).
You can also hover over "Copy URL" to view the URL.
Select this to conveniently open the URL of the folder or file in your default web browser (assuming you're logged in).
You can also hover over "Open URL" to view the URL.
Also included in the status submenu is a "Recent Files" history view, showing the last twenty documents that the Files.com desktop app has had activity on.
Clicking on these items will reveal those documents in the Finder (Mac) / File Explorer (Windows), assuming they are documents that still exist (that is, the activity you're clicking on isn't a deletion).
Activity includes delete, create, upload, download, and sync errors. You'll notice that this activity is sometimes shown as coming from you, and at other times shown as coming from your Files.com site. Activity from you includes changes you've made to documents locally through the desktop app (which get pushed to your Files.com site). Activity from your Files.com site might include changes that another user has made, or even changes that you yourself have made through another app (such as the web app).
You can select "Clear Menu" (located beneath the "Recent Files" history view) to clear the history at anytime.
On Windows devices, you can change the drive letter that will be used by each connection on the Files.com app. Because this setting is specific to each connection (and you can have more than one connected account), you change this by going to the Edit Account option while hovering over your Files.com account via the context menu from the Windows system tray icon.
On Windows, the desktop application logs are located at C:\Users[USERNAME]\AppData\Roaming\com.files. On Mac, the logs are located at ~/Library/Logs/Files.com/files.com.log.
If you receive a Windows Error message referencing "0x80070643", this is a Microsoft error related to your .NET Framework installation.
Fortunately there are a couple of simple steps that normally work to resolve it:
- The first recommended step is to simply try rebooting your system, and then try the install again.
- If you still receive the same error after rebooting, download the .NET framework Repair Tool from Microsoft and run it.
One other possible cause of this error is antivirus software. When we've seen this in the past, it has been triggered by Avast antivirus software. Users have found that they can temporarily turn off Avast, complete the install, then turn Avast back on.
If you're on a Windows machine, use these steps to uninstall the app:
- Click the Start button and enter "Files.com" in the search box (or right-click the Files.com application in the menu).
- Click Uninstall to uninstall the application.
If you're on a Mac, use these steps to uninstall the app:
- Locate the Files.com app in the Finder. Most apps are in your Applications folder, which you can open by clicking Applications in the sidebar of any Finder window.
- Drag the app to the Trash, or select the app and choose File > Move to Trash. If you're asked for a user name and password, enter the name and password of an administrator account on your Mac. This is probably the name and password you use to log in to your Mac.
- To delete the app, choose Finder > Empty Trash.
Now you can have your logo on every one of your users' desktops! Our Premier plan includes the ability to give the Files.com desktop app your own custom look.
The entire app, including the installer, mounted disk, context menu, menu bar (Mac) / system tray (Windows), and app icon use your graphics, giving your users a fully-integrated, branded experience.
To get started, contact our Customer Success team by submitting a support request, attaching your graphics (described below) to the ticket.
Please download this photoshop template, which includes the background for the disk icon. Then prepare the following assets:
- banner.bmp - 493×58 bitmap; used for the header of the Windows installer. Please use a white background.
- welcome.bmp - 163×314 bitmap; used as the sidebar of the Windows installer's first step (not shown with banner.bmp). Please use a white background.
- email@example.com - 1024x1024, 24-bit PNG; used for the Mac app icon. Supports transparency.
- firstname.lastname@example.org - 32x32, 24-bit PNG; used as the Mac menu bar icon. Please use white.
- ConnectionProfile-DiskIcon-128px.tif - 128x128 TIFF; used as the "disk" icon for mounted drives.
- ConnectionProfile-DiskIcon-64px.tif - 64x64 TIFF; also used as the "disk" icon for mounted drives.
The Desktop App is a powerful part of the Files.com platform, but it should not be used as part of your business automations. Instead we recommend our Command Line Interface (CLI) App or our SDKs.
Get Instant Access to Files.com
The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.Start My Free Trial