Uploading Files
Getting your content into mudstack.
Getting your content into mudstack is the first step towards adopting an artist-first Digital Asset Manager (DAM) and Version Control System (VCS).
There are 2 different scenarios to consider— first time uploads and new version uploads.
First Time Uploads
Ideally, you have an existing directory on your local machine that is set up with the folder structure and file naming conventions you want to continue to use on mudstack.
Uploading Folders
Using the desktop application is currently the only way to maintain your folder structure during upload.
-
Install the desktop app and log in to your mudstack account.
-
Navigate to the
Local
area of the application and allow mudstack to manage the directory where your project content lives. This directory should be dedicated to a specific workspace in mudstack. Once mudstack has indexed this directory (this might take a while depending on the size of the directory), you can search and categorize the contents (via tags and libraries) locally. -
To send the contents of this directory to the cloud workspace, right-click and select
Upload
. -
Next, you can pick the account and workspace where this directory should be uploaded.
Depending on the size of the directory, this step could take several minutes or upwards of an hour.
Known bug: June 26, 2023
Uploading files this way is significantly
slower than the method below and the progress indicator does not show. This
will be fixed soon.
Single or Multi-File Uploads
If you just want to upload a handful of files (or even several hundreds) from a local folder into a cloud folder without having mudstack manage the directory, you can do that as well.
You can only add files, not folders, this way. This method works both in the browser and the desktop app.
To do this:
-
Start in the location on the cloud workspace where you want to add the files. For instance,
Workspace A > Folder 1 > Subfolder 1.1
. From here, click theUpload files
button and use your Windows Explorer or Mac Finder to locate and select the files you would like to add. -
After you select your files, you should see a progress indicator appear in the lower left of the screen that shows you an approximate time remaining and file completion count. Once all the files are finished uploading, the view should update to show all the newly added files.
New Version Uploads
Once the first version of a file is in the mudstack cloud, it is easy to add new versions without overwriting any older versions.
From Mudstack Local
- Find the file you want to upload a new version(s) for. Click to select.
- In the right sidebar, click the
Versions
tab. - Pick the version you want to upload, add an optional description and click
Commit
, thenUpload
. - Select the account and workspace where you want to send this version to.
As long as the path of the file in your local folder matches the path of the file in the cloud workspace, the cloud file will receive the new version.
If the path does not match, then a new file will be created at the root of the workspace.
From the File View
When viewing a file in the mudstack cloud workspace, you can also navigate to the Versions
section in the right sidebar and click the Upload
button.
This method does not require you to ensure that the paths match— you can add a new version from anywhere on your local hard drive.
Syncing Files
Being able to selectively sync (up to and down from the cloud) files/folders/libraries is much more convenient than the manual method of uploading/downloading files.
We are actively developing this feature. It is slated for a November 2023 release.
Key requirements:
- Ensuring that the latest versions of synced files are available locally.
- Notifying users of any conflicts when they are working on a file locally and it has new versions available in the cloud.
- Providing options for conflict resolution.
- Easy uploads of new local versions.
- Non-destructive file versioning with painless rollbacks.
Was this page helpful?