Skip to content

Local library

The local library brings the music stored on your computer into JamCloud. A small program, the JamCloud agent, runs on the computer: it indexes your music folder and keeps one secure connection to JamCloud. Nothing is uploaded until you play or import a track, and no port is opened on your computer.

Not every account includes it; an administrator can grant it. When it isn’t available, Settings › Local library says so.

  1. Open Settings › Local library and choose Add a computer.
  2. Pick your system (macOS, Windows or Linux) and Copy the command.
  3. On the computer with your music, open a terminal (macOS: Applications › Utilities › Terminal; Windows: PowerShell from the Start menu) and paste the command.
  4. Keep the JamCloud window open: after a few seconds the computer appears. Give it a name and press Save.

The command installs the agent, links it to your account and starts it with your session. It is valid for 15 minutes and works once; New command gives another. You can pair up to 3 computers.

Your Music folder is added first. To add or remove folders, run on the computer:

jamcloud-agent library add ~/Desktop/Rehearsals
jamcloud-agent library remove ~/Music
jamcloud-agent status

Library › My computer shows the music of the computer (choose it at the top when you have several), with the same view in Practice as the My computer panel.

  • Browse: on the left, a tree by Artists (then their albums, by year), Albums (A–Z), Genres (then artists and albums), Years (decades, years, albums) or Folders. Pick a node to list its tracks on the right, with the album cover when the files or their folder have one (cover.jpg, folder.png…).
  • Album covers: an artist, genre, year or letter opens on its albums as a grid of covers; Tracks switches to the list (and Albums back, also for all tracks). Click a cover to open the album, the play button on it to play the album, and the back arrow to return to the grid.
  • Search: type in the search box (or press /). Accents and small typos are forgiven (bjork, radiohed), and every word must match, across title, artist, album, genre and year (bjork 1997). Results come grouped: artists, albums, then tracks; Enter plays the first track.
  • Play: click a track to play it and queue the ones after it, Play for the whole node, + or Add to queue for the queue. From the Library page it opens Practice; in the panel it plays without leaving. It works from any device — your phone included — as long as the computer is on. The waveform, sound, mixer, spectrum, tuner and metronome panels work as usual; sections, harmony, boards and stems need the track in a workspace.

The whole list is kept on this device, so browsing and searching stay instant even with tens of thousands of tracks, and the last known list still shows while the computer is off. The refresh button picks up new files at once (the agent also rescans every 30 minutes). Files browsers can’t play (AIFF, for example) are greyed out.

The tree and the search need agent 0.2.0 or later: with an older agent, a plain list shows instead, with a note — run the install command again from Settings › Local library to update it.

Lossless files (FLAC, WAV) play from a lighter AAC copy made by the computer at your Stream preferences quality (64, 128 or 256 kb/s), so they start in a few seconds instead of downloading the whole file; Original (as uploaded) plays the file as it is. This needs agent 0.3.0 or later, and on Windows or Linux ffmpeg installed (macOS has what it needs); otherwise the file plays as it is. Imports always send the original.

Select tracks, choose Import, then the workspace (and folder). The computer sends the files directly to JamCloud’s storage; progress shows above the list. Imported tracks count against the storage of the workspace’s owner, like any upload.

Settings › Local library › Remove disconnects the computer at once; the agent forgets its link to your account. On the computer, jamcloud-agent unpair does the same, and jamcloud-agent uninstall also stops it from starting with your session.

JamCloud only sees track details and paths inside your music folders, never the rest of your disk.