Your asset library

Your asset library keeps your own files for Perlin to build with: logos and images, fonts, 3D models, music and sound, and video. Upload a file once and it's there for every piece you make, now and later, kept with your account.

The library needs an account. Signed out, the Assets panel invites you to create one, with Create an account and Sign in.

Opening the library

Click Assets on the rail, or press A. On a phone it's the Assets tab. The same library also opens from the prompt box: the attach button's Choose from your assets, described in Using assets in a piece.

Uploading files

1. Open the Assets panel

   Press A, or click Assets on the rail.

2. Pick a folder, if you like

   Click a folder in the row at the top, and what you upload goes into it.

3. Add your files

   Click Upload in the panel's header (Upload files on an empty library) and choose one or more files. Or drag them from your computer and drop them anywhere on the studio while the panel is open: the studio shows "Drop to add assets".

4. Wait for the tiles

   Files go up one at a time, each as a tile with a spinner. A large file shows how far it has got. Each one lands at the top of the panel when it's in.

Files you drop onto the studio go in no folder, wherever you drop them. Use Upload to put files straight into the folder you have open.

With the Assets panel closed, a dropped font, 3D model, sound or video is still added to your library, and is attached to your next prompt as well. Dropped images are different: they become reference images for the look of the next piece, not assets. See Reference images and files.

Formats and sizes

An account's library holds up to 500 files or 500 MB in all, whichever comes first. The foot of the panel shows where you are, as in "12 files · 48 MB of 500 MB". A full library turns new files away until you delete something.

A few things to know:

• SVG is drawn at 2,048 pixels on its long side and kept as a PNG. Other formats your browser can open, such as AVIF, are kept as PNG at up to 4,096 pixels.
• Video has to play in the browser you upload it from, since that's where pieces play it. A phone's HEVC .mov can be turned away in a browser that doesn't play HEVC; export it as an MP4 (H.264) or a WebM and upload that. A video file with no picture belongs in the library as audio.
• The studio checks what each file is from its contents, not its name, and takes only the formats above. Each asset is named after its file, without the extension.

Folders

The row at the top of the panel holds your folders:

• All shows everything.
• Each folder has a button of its own.
• Unsorted shows the assets in no folder, once you have folders.
• The folder icon (New folder) makes one. Type a name of up to 40 characters and press Enter.

Folders are one level deep. A folder lasts as long as something is in it, so a new one is opened for you to upload into or move assets to straight away.

Under the folders, a second row filters by kind: All, Images, Fonts, 3D, Audio and Video.

Organising your assets

Click a tile to select it, and click again to let it go. Shift-click selects every asset between the last one you picked and this one. With something selected, a bar at the foot of the panel offers:

• Use in prompt, which attaches the selection to your next message
• Download, or Download as a ZIP for several
• Rename, for one asset, up to 80 characters
• Move to folder, with your folders, No folder and New folder…
• The bin, to delete

Select all in the bar, with a count beside it, takes every asset on show, and Clear lets the selection go. A selection holds while you switch folders and filters.

Renaming or moving an asset doesn't affect the pieces that use it.

Deleting assets

Select them, click the bin, then click again to confirm ("Delete it?" for one, "Delete 3?" for three). Deleting is for good: the file goes too, and pieces that use it lose it. What a piece does without it is in Using assets in a piece.

Who can see your assets

Your library is private to you: nobody else can see its list. A piece that uses one of your assets shows it to everyone who plays that piece, though, so a piece you share or publish shows its logo, plays its music and so on, and a remix of it can keep using them.

Related

• Using assets in a piece
• Generating assets
• Previewing and downloading
• Limits