[{"data":1,"prerenderedAt":540},["ShallowReactive",2],{"docs":3,"doc:\u002Fdocs\u002Fguide\u002Fwindows":88},[4,8,12,16,20,24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84],{"path":5,"title":6,"description":7},"\u002Fdocs\u002Fcodemods","Codemods","A codemod is a small program that changes Live Sets. livesaver runs it over folders of sets, shows\nwhat would change, and with --apply writes the changes the same way every livesaver command\ndoes: the result must be well-formed XML, Live's backup scheme is followed\n(Backup\u002F\u003Cset> [date time].als), the run is journaled, and livesaver undo \u003Crun> puts every set\nback.",{"path":9,"title":10,"description":11},"\u002Fdocs\u002Fformat","Ableton Live file formats — what livesaver relies on","Facts collected from Live's own files (verified against real sets) and public research\n(Steinberg VST3 SDK, JUCE, Ableton's maxdevtools). Each page names its sources.",{"path":13,"title":14,"description":15},"\u002Fdocs\u002Fformat\u002Fcontainers","Containers and id spaces","How Live's files are packed: which are gzip-compressed XML and which are binary, what lies beside them, and how the ids inside a document are numbered.",{"path":17,"title":18,"description":19},"\u002Fdocs\u002Fformat\u002Ffileref","FileRef","A \u003CFileRef> locates one file. It appears in many containers, but only some are real dependencies.",{"path":21,"title":22,"description":23},"\u002Fdocs\u002Fformat\u002Ffinder","Finder tags, comments and plug-in bundles (macOS)","What status, reorg and the plug-in inventory read and write outside Live's own files.",{"path":25,"title":26,"description":27},"\u002Fdocs\u002Fformat\u002Ffingerprints","Fingerprints","How Live recognises a file again: the size and the checksum it stores with every reference, where vendors and pack updates break that, and what livesaver compares instead.",{"path":29,"title":30,"description":31},"\u002Fdocs\u002Fformat\u002Flive-setup","Live installation and library locations","Where Live keeps its app resources, its library folders and its own databases, and how livesaver finds them without being told. Everything below was read on a Mac; Windows is at the end, from Ableton's documentation.",{"path":33,"title":34,"description":35},"\u002Fdocs\u002Fformat\u002Fplugins","Plug-ins in Live Sets","How a Live Set stores a plug-in in each format, how the same plug-in is recognised across formats, and what an upgrade from VST2 to VST3 has to carry over.",{"path":37,"title":38,"description":39},"\u002Fdocs\u002Fformat\u002Fversions","\u003CAbleton> root attributes per Live version","The root is \u003CAbleton MajorVersion MinorVersion SchemaChangeCount Creator Revision>. Creator is \"Ableton Live x.y.z\".",{"path":41,"title":42,"description":43},"\u002Fdocs\u002Fguide\u002Fbrowser","In the browser","The app also runs on its own, as a page in your browser. It reads the folders you give it and changes nothing: good for a first look, or on a computer where you cannot install anything. In Chrome and Edge it can also fix samples and upgrade plug-ins, if you switch that on: see Fixing in the page.",{"path":45,"title":46,"description":47},"\u002Fdocs\u002Fguide\u002Fcommand-line","The command line","Everything the app does, the livesaver command does too, and more: project status in Finder, a catalog of your sets to search, and codemods. Every command only plans unless you pass --apply.",{"path":49,"title":50,"description":51},"\u002Fdocs\u002Fguide\u002Fgetting-started","Getting started","livesaver finds the samples your Ableton Live sets have lost, collects them into their projects, and shows which plug-ins are missing. This page takes you from nothing to your first scan.",{"path":53,"title":54,"description":55},"\u002Fdocs\u002Fguide\u002Fhistory","History and undo","Everything livesaver changes is written down as a run: what it was asked, every step it took, and the original of every set it rewrote. That is what makes an undo possible, also weeks later.",{"path":57,"title":58,"description":59},"\u002Fdocs\u002Fguide\u002Fmissing","When samples stay missing","A fix can only find what is in the folders it searches. What stays missing is listed by where it came from, because what helps differs: a pack is installed again, an old drive is plugged in, a folder is added.",{"path":61,"title":62,"description":63},"\u002Fdocs\u002Fguide\u002Fplugins","Plug-ins","Live finds a plug-in by its format and its id, never by its name. livesaver reads which plug-ins your sets use and compares them with what is installed, the way Live does, so you know before you open a set what will be missing in it.",{"path":65,"title":66,"description":67},"\u002Fdocs\u002Fguide\u002Fquestions","Questions and answers","Short answers to what comes up first. If yours is not here, ask on GitHub.",{"path":69,"title":70,"description":71},"\u002Fdocs\u002Fguide\u002Fsafety","How your work is kept safe","livesaver edits the files your music lives in. These are the rules it keeps, so that nothing is lost.",{"path":73,"title":74,"description":75},"\u002Fdocs\u002Fguide\u002Fsamples","Fix missing samples","A set that has lost its samples opens in Live with “Media files are missing”. livesaver finds the files again by what they are, puts them into the project, and points the set at them, for every project at once.",{"path":77,"title":78,"description":79},"\u002Fdocs\u002Fguide\u002Fwindows","livesaver on Windows","livesaver is made and tested on a Mac. Windows is new: it is built from what Ableton documents about Live on Windows and from the way sets that were saved on Windows store their files. No one has tried it on a Windows computer with Live yet. This page says what is there, what differs from a Mac, and what is not known.",{"path":81,"title":82,"description":83},"\u002Fdocs\u002Fverification","Verification","What is checked, and how to repeat it. Checks on a real library are read-only; everything that\nwrites runs on temporary copies.",{"path":85,"title":86,"description":87},"\u002Fdocs\u002Fweb","The web app","apps\u002Fweb is one app (Vite, Vue, Nuxt UI) that runs in two situations:",{"id":89,"title":78,"body":90,"description":79,"extension":534,"meta":535,"navigation":536,"path":77,"seo":537,"stem":538,"__hash__":539},"docs\u002Fdocs\u002Fguide\u002Fwindows.md",{"type":91,"value":92,"toc":523},"minimark",[93,97,106,109,114,122,126,264,274,282,286,307,314,317,320,366,370,390,460,464,494,498,514],[94,95,78],"h1",{"id":96},"livesaver-on-windows",[98,99,100,101,105],"p",{},"livesaver is made and tested on a Mac. Windows is new: it is built from what Ableton documents about Live on Windows and from the way sets that were saved on Windows store their files. ",[102,103,104],"strong",{},"No one has tried it on a Windows computer with Live yet."," This page says what is there, what differs from a Mac, and what is not known.",[98,107,108],{},"So try a fix on a copy of a project first. A fix keeps a backup of every set it rewrites and can be undone, on Windows as on a Mac; and a scan changes nothing anywhere.",[110,111,113],"h2",{"id":112},"what-is-the-same","What is the same",[98,115,116,117,121],{},"Scan, review, fix, undo, the history and the reports, in the browser and with ",[118,119,120],"code",{},"livesaver web",": everything in this guide applies. Where a page of the guide says \"your Mac\", read \"your computer\"; where it differs on Windows, it is said here.",[110,123,125],{"id":124},"where-things-are","Where things are",[127,128,129,144],"table",{},[130,131,132],"thead",{},[133,134,135,138,141],"tr",{},[136,137],"th",{},[136,139,140],{},"On a Mac",[136,142,143],{},"On Windows",[145,146,147,165,178,193,208,223,238,251],"tbody",{},[133,148,149,153,159],{},[150,151,152],"td",{},"Your User Library and the Factory Packs",[150,154,155,158],{},[118,156,157],{},"Music\u002FAbleton"," in your home folder",[150,160,161,164],{},[118,162,163],{},"Documents\\Ableton"," in your user folder",[133,166,167,170,173],{},[150,168,169],{},"Live's own content (the Core Library)",[150,171,172],{},"inside the Ableton Live app",[150,174,175],{},[118,176,177],{},"C:\\ProgramData\\Ableton\\Live 12 Suite\\Resources",[133,179,180,183,188],{},[150,181,182],{},"Libraries of Native Instruments",[150,184,185],{},[118,186,187],{},"\u002FUsers\u002FShared",[150,189,190],{},[118,191,192],{},"C:\\Users\\Public\\Documents",[133,194,195,198,203],{},[150,196,197],{},"Live's plug-in database",[150,199,200,158],{},[118,201,202],{},"Library\u002FApplication Support\u002FAbleton\u002FLive Database",[150,204,205,164],{},[118,206,207],{},"AppData\\Local\\Ableton\\Live Database",[133,209,210,213,218],{},[150,211,212],{},"Live's settings, which say where your library is",[150,214,215],{},[118,216,217],{},"Library\u002FPreferences\u002FAbleton\u002FLive 12.x",[150,219,220],{},[118,221,222],{},"AppData\\Roaming\\Ableton\\Live 12.x\\Preferences",[133,224,225,228,233],{},[150,226,227],{},"What livesaver keeps (runs, originals for the undo)",[150,229,230],{},[118,231,232],{},"Library\u002FApplication Support\u002Flivesaver",[150,234,235],{},[118,236,237],{},"AppData\\Local\\livesaver",[133,239,240,243,246],{},[150,241,242],{},"What an undo takes out of a project",[150,244,245],{},"the Trash",[150,247,248],{},[118,249,250],{},"AppData\\Local\\livesaver\\Trash",[133,252,253,256,261],{},[150,254,255],{},"Your settings for livesaver",[150,257,258,158],{},[118,259,260],{},".config\u002Flivesaver\u002Fconfig.json",[150,262,263],{},"the same, in your user folder",[98,265,266,269,270,273],{},[118,267,268],{},"ProgramData"," and ",[118,271,272],{},"AppData"," are hidden folders. In File Explorer and in a folder dialog, type the path into the address bar.",[98,275,276,277,281],{},"If your folders are elsewhere (a library on another drive), livesaver on your computer reads that from Live's settings, and you can name any folder yourself: see ",[278,279,46],"a",{"href":280},"command-line#settings",".",[110,283,285],{"id":284},"paths","Paths",[98,287,288,289,292,293,296,297,292,300,303,304,306],{},"A set names a file on Windows by its path with a drive. Live 9 and 10 wrote it with ",[118,290,291],{},"\\"," (",[118,294,295],{},"C:\\Users\\you\\Music\\kick.wav","); into a set of today's format Live writes it with ",[118,298,299],{},"\u002F",[118,301,302],{},"C:\u002FUsers\u002Fyou\u002FMusic\u002Fkick.wav","). livesaver reads both, shows paths with ",[118,305,299],{},", and writes them that way.",[98,308,309,310,313],{},"A path of the other system is no file: on Windows, a set from a Mac that names ",[118,311,312],{},"\u002FUsers\u002Fyou\u002FMusic\u002Fkick.wav"," misses that sample until it is found again by its name and fingerprint, and the other way round.",[110,315,42],{"id":316},"in-the-browser",[98,318,319],{},"The page sees that it runs on Windows, and names the folders above where it asks for them.",[321,322,323,342,357],"ul",{},[324,325,326,329,330,333,334,337,338,341],"li",{},[102,327,328],{},"Live's own content."," In File Explorer, type ",[118,331,332],{},"C:\\ProgramData\\Ableton"," into the address bar and open the folder of your Live. Drag its ",[118,335,336],{},"Resources"," folder onto the sample folders. The page shows these steps under ",[102,339,340],{},"Show me how",". Only the Core Library in it is read.",[324,343,344,347,348,269,350,352,353,356],{},[102,345,346],{},"Your browser may say it cannot open the folder."," Chrome and Edge keep some folders of the system from a page, as they keep an app's folder on a Mac; ",[118,349,268],{},[118,351,272],{}," are likely among them. If your browser says so, press ",[102,354,355],{},"Cancel",": the page reads the folder for this visit all the same, and you add it again next time.",[324,358,359,362,363,281],{},[102,360,361],{},"Fixing in the page"," works in Chrome and Edge, as on a Mac: see ",[278,364,42],{"href":365},"browser#fixing-in-the-page",[110,367,369],{"id":368},"on-your-computer","On your computer",[98,371,372,373,379,380,385,386,389],{},"livesaver needs ",[278,374,378],{"href":375,"rel":376},"https:\u002F\u002Fnodejs.org",[377],"nofollow","Node.js"," 22.13 or newer, or ",[278,381,384],{"href":382,"rel":383},"https:\u002F\u002Fbun.sh",[377],"Bun",". ",[278,387,50],{"href":388},"getting-started#install-livesaver"," has the commands; they are the same on Windows.",[321,391,392,411,421,430],{},[324,393,394,395,398,399,401,402,292,404,407,408,410],{},"A path can be typed either way: ",[118,396,397],{},"livesaver doctor C:\\Users\\you\\Music\\Projects"," or with ",[118,400,299],{},". In the settings file write ",[118,403,299],{},[118,405,406],{},"\"C:\u002FSamples\"","): a ",[118,409,291],{}," has a meaning of its own there.",[324,412,413,416,417,420],{},[102,414,415],{},"Never while Live runs."," livesaver asks Windows which programs run, and writes nothing while one of them is called like Live (",[118,418,419],{},"Ableton Live 12 Suite.exe",").",[324,422,423,426,427,429],{},[102,424,425],{},"An undo"," moves what a fix copied to a trash folder of livesaver's own, ",[118,428,250],{},", and not to the Recycle Bin. A program that sends a file to the Recycle Bin without stopping to ask you loses it where the Recycle Bin cannot take it (a file on a USB stick, or a very large one): Windows then deletes the file for good. Nothing livesaver removes may end like that. Empty the folder when you no longer need what is in it.",[324,431,432,435,436,439,440,439,443,439,446,439,449,439,452,455,456,459],{},[102,433,434],{},"A name Windows cannot make"," is never written. A set from a Mac may name a sample with a ",[118,437,438],{},":",", ",[118,441,442],{},"?",[118,444,445],{},"*",[118,447,448],{},"\"",[118,450,451],{},"\u003C",[118,453,454],{},">"," or ",[118,457,458],{},"|"," in its name, or with a space or a dot at its end: such a sample is copied into the project under the name of the file that was found on your disk.",[110,461,463],{"id":462},"what-windows-does-not-have","What Windows does not have",[321,465,466,476,482,488],{},[324,467,468,471,472,475],{},[102,469,470],{},"Finder tags and comments."," ",[118,473,474],{},"livesaver status"," measures every set and writes its reports and the rating sheet, but marks nothing in File Explorer.",[324,477,478,481],{},[102,479,480],{},"Rosetta."," No plug-in is \"Rosetta only\" on Windows.",[324,483,484,487],{},[102,485,486],{},"Audio Units."," A set from a Mac that uses an Audio Unit misses that plug-in on Windows.",[324,489,490,493],{},[102,491,492],{},"A look into the plug-ins themselves."," On a Mac livesaver also reads the plug-in bundles; on Windows it knows the plug-ins that Live has scanned, from Live's plug-in database. A plug-in installed since Live last ran is not known until Live has seen it.",[110,495,497],{"id":496},"what-is-tested-and-what-is-not","What is tested, and what is not",[321,499,500,503,506],{},[324,501,502],{},"Tested, on a Mac: the handling of Windows paths, of sets that Live 9 and 10 saved on Windows, and of Ableton's folders as Windows has them, on made-up disks with drive letters; and the app in browsers that are told they run on Windows.",[324,504,505],{},"Tested, on a Windows machine, by automated tests on every change: the command line fixes sets that Live saved and takes the fix back, moves what the undo removes to its trash folder, and writes nothing while a program called like Live runs. No Live is installed on that machine.",[324,507,508,509,513],{},"Not tested: livesaver with Live on a Windows computer, and the app in a browser on Windows. Where Live keeps its folders on Windows is taken from Ableton's documentation. No set that Live 11 or 12 saved on Windows was at hand: what such a set stores is known only as far as ",[278,510,512],{"href":511},"..\u002Fformat\u002Ffileref#windows","the format notes"," say.",[98,515,516,517,522],{},"If something does not fit your computer, please ",[278,518,521],{"href":519,"rel":520},"https:\u002F\u002Fgithub.com\u002FPolobase\u002Flivesaver\u002Fissues",[377],"tell us",": what you did, what livesaver said, and your versions of Windows and Live.",{"title":524,"searchDepth":525,"depth":525,"links":526},"",2,[527,528,529,530,531,532,533],{"id":112,"depth":525,"text":113},{"id":124,"depth":525,"text":125},{"id":284,"depth":525,"text":285},{"id":316,"depth":525,"text":42},{"id":368,"depth":525,"text":369},{"id":462,"depth":525,"text":463},{"id":496,"depth":525,"text":497},"md",{},true,{"title":78,"description":79},"docs\u002Fguide\u002Fwindows","I71ygYX_da5Og6nmBLxuzuR_guWBVHfxPK8BYZhbSsU",1791245843772]