User Guide

Everything you need to get started with DAWShare and collaborate on music projects.

1. Overview

DAWShare is a version-controlled file sharing platform built for music production teams. It lets you push and pull DAW project folders (Logic Pro, Ableton Live, Pro Tools, and more) to a shared server, with automatic versioning, deduplication, and encryption.

The system has three main components:

2. Installation

macOS

  1. Download the DAWShare installer DMG from your team's administrator
  2. Open the DMG and run DAWShare Installer
  3. Enter the server address provided by your administrator
  4. Choose your setup type:
    • Invite Code — for new users. Enter your invite code, choose a username, and provide your email. Your account is created and your Master Key is displayed
    • Master Key — for existing users setting up a new device. Enter your Master Key to link the device to your account
    • Update Only — reinstall the app without changing your account
  5. The installer offers to save your Master Key to Keychain (recommended) so you won't need to enter it again
  6. The DAWShare app is installed to your Applications folder and is ready to sync

Tip: Saving to Keychain is strongly recommended. It enables automatic web login without entering your Master Key each time. You can retrieve your Master Key later from Keychain Access by searching for "DAWShare".

Windows

Download the Windows installer from your team's administrator. Run DAWShare2 Installer and follow the same steps as macOS above.

Web Only

Use the web interface to browse projects, view version history and notes, manage collab members, and trigger sync operations. The desktop app is required for actual file transfer — end-to-end encryption means file bytes can only be encrypted and decrypted on a device holding your Master Key, never in the browser.

3. Account Setup

Registration

DAWShare uses invite-only registration. Your administrator will provide a platform invite code. The installer handles registration directly — no browser needed:

  1. Run the DAWShare installer and choose Invite Code
  2. Enter your invite code, desired username, and email address
  3. Your account is created and your Master Key is displayed. This is your password for the web interface and other devices
  4. Save to Keychain when prompted (strongly recommended) — or copy it to a password manager

Important: Your Master Key is hashed on the server and cannot be recovered from us. If you lose it and didn't save to Keychain, you can use "Forgot Key" on the login page (requires a verified email) or contact your administrator for a reset.

Email Verification

From your Profile page, click Send Verification Email to verify your email address. A verification link is sent (valid for 24 hours). Verifying your email enables the self-service "Forgot Key" recovery feature.

Two-Factor Authentication (2FA)

For web login security, you can enable TOTP-based 2FA from your Profile page:

  1. Click Enable Two-Factor Authentication on your Profile page
  2. Scan the QR code with a free authenticator app (Microsoft® Authenticator, Google® Authenticator, Authy, 1Password, etc.)
  3. Enter the 6-digit code from the app to confirm
  4. Save the recovery codes displayed — each can be used once if you lose access to your authenticator

Desktop App Authentication

If you saved your Master Key to Keychain, the desktop app can auto-login to the web interface using a secure one-time token (expires in 60 seconds, single use). No manual key entry is needed. If you didn't save to Keychain, you'll log in manually on the web with your Master Key.

Multi-Device

To sync from a second machine, run the DAWShare installer on the new device and choose Master Key at setup. Enter your Master Key and the app will link the device to your account and recover your project folder mappings from the server automatically.

You can also use the QR Code option when viewing your Master Key in the app to transfer it to another machine without typing the full key.

4. Collabs & Projects

What is a Collab?

A Collab (short for collaboration group) is a workspace shared among team members. Each collab has its own:

Creating a Collab

From the web interface, click the Collabs icon in the navigation bar. Click Create Collab and enter a name. You'll be set as the owner.

Inviting Members

On the collab page, you'll find an Invite Code. Share this with team members so they can join. Codes can be regenerated if compromised.

Creating a Project

Projects are created automatically the first time you push a folder from the desktop app.

5. Pushing (Uploading) a Project

Pushing sends your local project folder to the server, creating a new version.

First Push (New Project)

  1. Open the web interface and navigate to your collab's project list
  2. Click the Sync button (or use the sync link from the project page) and choose Push
  3. The desktop app opens and prompts you to select the project folder
  4. Enter a name for the project
  5. The app syncs the folder to the server. A progress page opens in your browser
  6. When complete, the project page shows your first version

Subsequent Pushes

For existing projects, the app remembers your folder location. It performs a dry-run comparison first and tells you how many files changed. You can add optional notes describing what changed before confirming the push.

Only changed bytes transfer over the wire (delta sync via rsync). A 2 GB project with a few tweaked audio files syncs in seconds, not minutes.

What Gets Pushed

The entire contents of your selected folder are synced, excluding:

6. Pulling (Downloading) a Project

Pulling downloads the latest version (or a specific version) from the server to your local folder.

  1. From the project page in the web interface, click Sync and choose Pull
  2. The desktop app opens. If you've synced this project before, it uses the same folder. Otherwise, it asks you to pick a folder
  3. The app shows how many files will be downloaded and asks for confirmation
  4. Existing files that will be overwritten are automatically backed up to a timestamped folder
  5. The project files are synced to your local folder

Tip: You can pull a specific older version from the project's version history page, not just the latest.

7. Web Interface

Navigation Bar

The top navigation bar appears on every page. Each icon button is described below.

IconLabelDescription
Projects View all projects in the current collab
Recent Projects Quick-access dropdown of projects you've recently visited
Collabs Manage collabs, view members, join or create collabs, and share invite codes
Help Tips, keyboard shortcuts, app settings, and links to this User Guide and the FAQ
Terms of Use Opens the Terms of Use in a new tab
Profile Your account settings, 2FA, email notifications, device management, and sync preferences
Logout Sign out of the web interface

Project Page Actions

When viewing a project, the toolbar at the top provides these actions:

IconLabelDescription
Sync from Local Folder (Push) Opens the desktop app to sync your local project folder to the server, creating a new version
Sync to Local Folder (Pull) Opens the desktop app to download the latest version from the server to your local folder
Check Out Project Lock the project while you're working. Others will see it's checked out and by whom
Check In Release the lock after you've finished working and pushed your changes
Activity Log View all push, pull, and management events for this project
View Local Backups Browse files that were automatically backed up before previous pulls
Rename Project Change the project name
Prune Old Versions Delete older versions to free storage, keeping only the most recent N versions
Mark as Final Lock the project permanently as a finished product. No further versions can be added
Reopen Project Undo finalization and allow new versions to be added again
Delete Project Permanently delete the project and all its versions. This cannot be undone

Version Actions

Each version row in the history table has these actions:

IconLabelDescription
View Files Browse the project's files for this version. Click audio files to preview them in the browser
Delete Delete this version (only available when more than one version exists)

Pushing a Project

DAWShare 2 is end-to-end encrypted, so all file transfers go through the desktop app — that's where your encryption key lives. To push a project, open it in the web app and click Sync; the desktop app launches, encrypts the project locally, and uploads only the changed chunks. The web app itself does not move file bytes by design.

8. Local Backups

Before a pull overwrites files in your local project folder, DAWShare automatically backs up any files that will be changed. Backups are stored in a timestamped subfolder:

~/DAWShare Backups/ProjectName/YYYY-MM-DD_HH-MM-SS/

You can view and access your backups from the project page in the web interface by clicking the View Local Backups button.

Disabling Backups

If you prefer not to keep local backups (to save disk space), you can disable them in your Profile settings on the web interface. When disabled, pulls will still overwrite files but won't create backup copies.

9. Check-out / Check-in

DAWShare provides a check-out system to prevent conflicting edits:

Think of check-out like putting a "Recording in Progress" sign on a studio door — it tells others to wait before making changes.

10. Email Notifications

Stay informed about activity in your collabs without checking the web interface. From your Profile page, you can enable or disable notifications for each event type:

NotificationWhen it fires
New Version UploadsA collaborator pushes a new version to any project in your collabs
New ProjectsA new project is created in one of your collabs
Project Check-out/inA collaborator checks out or checks in a project
New Collab MembersSomeone joins one of your collabs

Tip: Verify your email address from your Profile page to ensure notifications are delivered. Unverified email addresses may not receive notifications.

11. Troubleshooting

Sync fails with "Authentication failed"

Your session may have expired or your Master Key may be incorrect. Re-open the app from the sync button in the web interface to generate a fresh session. If the issue persists, check that your Master Key in Keychain is correct by searching for "DAWShare" in Keychain Access.

"No changes detected" when files have changed

DAWShare uses rsync to detect changes by comparing file timestamps and sizes. If your DAW only modifies file contents without changing the timestamp, try saving the project again or touching the modified files.

App doesn't open when clicking sync links

App can't reach the server

Sync is slow

Initial pushes transfer the entire project. Subsequent pushes only send changed files (delta sync). If syncs remain slow, check your network connection and the size of the project. Large sample libraries will take longer.

Lost local folder mappings

If you switch to a new machine or accidentally delete ~/.dawshare_projects.json, DAWShare can recover your folder mappings from the server. The next time you try to sync a project, the app will check the server for your last known folder path and offer to use it.

12. FAQ

Which DAWs are supported?
DAWShare is DAW-agnostic. It syncs folders, so it works with any DAW that saves projects as files or folders: Logic Pro, Ableton Live, Pro Tools, FL Studio, Cubase, Studio One, REAPER, GarageBand, Reason, Bitwig Studio, and more. It can also sync standalone audio folders (stems, bounces, multitracks).
How much storage does each project use?
DAWShare deduplicates files across versions. If you push a 2 GB project and only change 3 audio files in the next version, only those 3 files count as new storage. Typical projects use 30-50% less storage than the raw sum of all versions. Default quotas are 1 GB per project and 10 GB per collab (configurable by your administrator).
Are my files encrypted?
Yes. Files are end-to-end encrypted using keys derived from your Master Key — the server stores only ciphertext it cannot read. Data in transit is protected by HTTPS. Each collab has its own encryption key, wrapped with your personal key.
Can I restore a previous version?
Yes. Every push creates an immutable version. From the project page, click on any version number to browse its files, then use the Pull button to download that specific version to your local folder.
What happens if two people push at the same time?
DAWShare creates sync sessions that serialize pushes. If two users try to push simultaneously, the second push will complete after the first, creating two separate versions. Use the check-out feature to coordinate and prevent conflicting edits.
Can I use DAWShare without the desktop app?
You can browse projects, version history, notes, and audit logs from the web alone. But pushing or pulling project files requires the desktop app — your encryption key lives there, and end-to-end encryption means file bytes can only be encrypted and decrypted on a device that holds your Master Key.
How do I move to a new computer?
Install the DAWShare app on your new machine and choose Master Key at setup. Enter your Master Key (or scan it as a QR code from your existing machine) and the app will link the device to your account and recover your project-to-folder mappings automatically.