Table of Contents

Download Assets

24 June 2020

  • C10 - removed extended image file formats in favor of built-in types.

26 November 2016

  • Release 9.145 - Removed MP3 download format due to incompatibilities with the mono platform.

6 October 2016

  • Release 9.133 - The command now can take a path instead of a name.

22 September 2016

  • Relese 9.127 - added the capability to download sounds in either mp3 or wav format.

10 July 2016

  • Relese 9.104 - added extended formats for the Windows platform.

23 May 2015

  • Release 8.13 - added the optional path parameter.

4 May 2014

  • Release 7.82 - added the optional format parameter for the Texture asset-type that will allow downloading to a different format other than JPEG2000.

14 December 2014

  • Release 7.28 - added.

The download command can be used to download assets from the grid.

Command Required Parameters Required Corrade Permissions Example
download group, password, item, type interact, inventory, system (if path is specified) 
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // Download a texture by UUID
            "command", "download",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // or the path to an item in Corrade's inventory
            "item", "742c887b-a8ed-ba7b-6e7f-8ba8e9d1d76a",
            "type", "Texture",
            "callback", wasURLEscape(URL)
        ]
    )
);
Parameter Possible Value Optional Parameter Possible Value Description Download from
type Texture format One of the supported formats. Downloads a texture in the specified format or in JPEG2000 format in case format was not specified. Asset server
Sound format One of the supported formats. Downloads a sound in OGG Vorbis format by default or in one of the supported formats. Asset server
Animation Downloads an animation in .animatn format. Asset server
Clothing Downloads wearables. Asset server
Bodypart Downloads body parts. Asset server
Landmark Downloads landmarks. Asset server
Gesture Downloads gestures. Asset server
Notecard Downloads notecards. Inventory
LSLText Downloads scripts. Inventory

and the data retrieved is compatible with the data supplied to the upload command.

Optional Parameter Possible Value Description
path A path-name ending in a file name (e.g.: C:\\Data\\Assets\\MyAsset.txt, or /mnt/data/Store.png) If a path is specified, then the asset will be saved to the file name indicated by the path.

In case the path optional parameter is not specified, then the asset will be downloaded, encoded as a Base64 string, then URI escaped and then placed as the value to the data key from the callback. If the path parameter is specified, then the data will be saved to the indicated path.

Supported Texture Image Formats

Grid clients such as Corrade download and upload textures to the grid in the JPEG2000 image format. The JPEG2000 image format is defined with various profiles, such that if the downloaded image is saved to a file and then inspected by the file or exiftool command line utilities, the detected image description should be: 

JPEG2000 codestream

which indicates a Profile 0 JPEG2000 which is what the SecondLife grid is using.

The proper file extension for such images is "j2c" which stands for "JPEG2000 codestream". Some tools may not properly implement nor respect the file extension. One tool that manages to correctly convert images to "JPEG2000 codestream" is ImageMagick with the mogrify tool. For instance, supposing that an image x.png exists in the current directroy, then issuing the command: 

mogrify -format "J2K" x.png

will result in a new image created x.j2k that, when inspected with the file tool: 

file x.j2k

should output: 

x.J2K: JPEG 2000 codestream

Other tools, such as ffmpeg will convert an image that when inspected with the file utility will read x.j2k: JPEG 2000 Part 1 (JP2) which will fail to upload with Corrade to SecondLife.

Furthermore, Corrade follows the SecondLife limits on texture uploads without any processing such that the user must ensure that the texture to be uploaded conforms to the specification.

One condition imposed by SecondLife is that the height and width of the image should be a power of 2 otherwise the image will not be uploaded. When uploading with a regular viewer, the viewer disguises a transformation that changes the image such that the width and height are a power of 2. However, when using Corrade, this transformation has to be performed beforehand in order for the upload to succeed.

2021/06/10 07:57

Supported Sound Formats

Corrade uploads OGG Vorbis files with the same specification that is listed on the official wiki. In case the uploaded sound seems distorted please check that all the parameters have been met. Typically, the audio rate is the culprit for most sound distortions and one must make sure that the rate of the file to be uploaded is $44100Hz$.

The following is a referential example used as a control to check whether sound uploads work properly. First, a sound is downloaded off the grid from the inventory at /My Inventory Sounds/lemmeout using the download command: 

curl --location --request POST 'http://CORRADE_HTTP_SERVER:CORRADE_HTTP_PORT' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'command=download' \
  --data-urlencode 'group=Wizardry and Steamworks' \
  --data-urlencode 'password=CORRADE_GROUP_PASSWORD' \
  --data-urlencode 'type=Sound' \
  --data-urlencode 'item=/My Inventory/Sounds/lemmeout'

where:

  • CORRADE_HTTP_SERVER the IP or hostname of the computer running Corrade,
  • CORRADE_HTTP_PORT the port that Corrade opens for HTTP commands,
  • CORRADE_GROUP_PASSWORD the group password for the group

resulting in the output: 

command=download&time=2025-10-26T18%3A11%3A42.060396Z&data=T2dnUwACAAAAAAAAAACLpXTGAAAAAFB1DdYBHgF2b3JiaXMAAAAAARErAAAAAAAASHEAAAAAAACZAU9nZ1MAAAAAAAAAAAAAi6V0xgEAAAAUVRa2C0D%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2B1A3ZvcmJpcw0AAABMYXZmNTcuNDEuMTAwAQAAAB8AAABlbmNvZGVyPUxhdmM1Ny40OC4xMDEgbGlidm9yYmlzAQV2b3JiaXMSQkNWAQAAAQAMUhQhJRlTSmMIlVJSKQUdY1BbRx1j1DlGIWQQU4hJGaV7TyqVWErIEVJYKUUdU0xTSZVSlilFHWMUU0ghU9YxZaFzFEuGSQklbE2udBZL6JljljFGHWPOWkqdY9YxRR1jUlJJoXMYOmYlZBQ6RsXoYnwwOpWiQii%2Bx95S6S2FiluKvdcaU%2BsthBhLacEIYXPttdXcSmrFGGOMMcbF4lMogtCQVQAAAQAAQAQBQkNWAQAKAADCUAxFUYDQkFUAQAYAgAAURXEUx3EcR5IkywJCQ1YBAEAAAAIAACiO4SiSI0mSZFmWZVmWpnmWqLmqL%2FuuLuuu7eq6DoSGrAQAyAAAGIYhh95JzJBTkEkmKVXMOQih9Q455RRk0lLGmGKMUc6QUwwxBTGG0CmFENROOaUMIghDSJ1kziBLPejgYuc4EBqyIgCIAgAAjEGMIcaQcwxKBiFyjknIIETOOSmdlExKKK20lkkJLZXWIueclE5KJqW0FlLLpJTWQisFAAAEOAAABFgIhYasCACiAAAQg5BSSCnElGJOMYeUUo4px5BSzDnFmHKMMeggVMwxyByESCnFGHNOOeYgZAwq5hyEDDIBAAABDgAAARZCoSErAoA4AQCDJGmapWmiaGmaKHqmqKqiKKqq5Xmm6ZmmqnqiqaqmqrquqaqubHmeaXqmqKqeKaqqqaqua6qq64qqasumq9q26aq27MqybruyrNueqsq2qbqybqqubbuybOuuLNu65Hmq6pmm63qm6bqq69qy6rqy7Zmm64qqK9um68qy68q2rcqyrmum6bqiq9quqbqy7cqubbuyrPum6%2Bq26sq6rsqy7tu2rvuyrQu76Lq2rsqurquyrOuyLeu2bNtCyfNU1TNN1%2FVM03VV17Vt1XVtWzNN1zVdV5ZF1XVl1ZV1XXVlW%2FdM03VNV5Vl01VlWZVl3XZlV5dF17VtVZZ9XXVlX5dt3fdlWdd903V1W5Vl21dlWfdlXfeFWbd93VNVWzddV9dN19V9W9d9YbZt3xddV9dV2daFVZZ139Z9ZZh1nTC6rq6rtuzrqizrvq7rxjDrujCsum38rq0Lw6vrxrHrvq7cvo9q277w6rYxvLpuHLuwG7%2Ft%2B8axqaptm66r66Yr67ps675v67pxjK6r66os%2B7rqyr5v67rw674vDKPr6roqy7qw2rKvy7ouDLuuG8Nq28Lu2rpwzLIuDLfvK8evC0PVtoXh1XWjq9vGbwvD0jd2vgAAgAEHAIAAE8pAoSErAoA4AQAGIQgVYxAqxiCEEFIKIaRUMQYhYw5KxhyUEEpJIZTSKsYgZI5JyByTEEpoqZTQSiilpVBKS6GU1lJqLabUWgyhtBRKaa2U0lpqKbbUUmwVYxAy56RkjkkopbRWSmkpc0xKxqCkDkIqpaTSSkmtZc5JyaCj0jlIqaTSUkmptVBKa6GU1kpKsaXSSm2txRpKaS2k0lpJqbXUUm2ttVojxiBkjEHJnJNSSkmplNJa5pyUDjoqmYOSSimplZJSrJiT0kEoJYOMSkmltZJKK6GU1kpKsYVSWmut1ZhSSzWUklpJqcVQSmuttRpTKzWFUFILpbQWSmmttVZrai22UEJroaQWSyoxtRZjba3FGEppraQSWympxRZbja21WFNLNZaSYmyt1dhKLTnWWmtKLdbSUoyttZhbTLnFWGsNJbQWSmmtlNJaSq3F1lqtoZTWSiqxlZJabK3V2FqMNZTSYikptZBKbK21WFtsNaaWYmyx1VhSizHGWHNLtdWUWouttVhLKzXGGGtuNeVSAADAgAMAQIAJZaDQkJUAQBQAAGAMY4xBaBRyzDkpjVLOOSclcw5CCCllzkEIIaXOOQiltNQ5B6GUlEIpKaUUWyglpdZaLAAAoMABACDABk2JxQEKDVkJAEQBACDGKMUYhMYgpRiD0BijFGMQKqUYcw5CpRRjzkHIGHPOQSkZY85BJyWEEEIppYQQQiillAIAAAocAAACbNCUWByg0JAVAUAUAABgDGIMMYYgdFI6KRGETEonpZESWgspZZZKiiXGzFqJrcTYSAmthdYyayXG0mJGrcRYYioAAOzAAQDswEIoNGQlAJAHAEAYoxRjzjlnEGLMOQghNAgx5hyEECrGnHMOQggVY845ByGEzjnnIIQQQueccxBCCKGDEEIIpZTSQQghhFJK6SCEEEIppXQQQgihlFIKAAAqcAAACLBRZHOCkaBCQ1YCAHkAAIAxSjknJaVGKcYgpBRboxRjEFJqrWIMQkqtxVgxBiGl1mLsIKTUWoy1dhBSai3GWkNKrcVYa84hpdZirDXX1FqMtebce2otxlpzzrkAANwFBwCwAxtFNicYCSo0ZCUAkAcAQCCkFGOMOYeUYowx55xDSjHGmHPOKcYYc8455xRjjDnnnHOMMeecc845xphzzjnnnHPOOeegg5A555xz0EHonHPOOQghdM455xyEEAoAACpwAAAIsFFkc4KRoEJDVgIA4QAAgDGUUkoppZRSSqijlFJKKaWUUgIhpZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoplVJKKaWUUkoppZRSSimlACDfCgcA%2FwcbZ1hJOiscDS40ZCUAEA4AABjDGISMOSclpYYxCKV0TkpJJTWMQSilcxJSSimD0FpqpaTSUkoZhJRiCyGVlFoKpbRWaymptZRSKCnFGktKqaXWMuckpJJaS622mDkHpaTWWmqtxRBCSrG11lJrsXVSUkmttdZabS2klFprLcbWYmwlpZZaa6nF1lpMqbUWW0stxtZiS63F2GKLMcYaCwDgbnAAgEiwcYaVpLPC0eBCQ1YCACEBAAQySjnnnIMQQgghUoox56CDEEIIIURKMeacgxBCCCGEjDHnIIQQQgihlJAx5hyEEEIIIYRSOucghFBKCaWUUkrnHIQQQgillFJKCSGEEEIopZRSSikhhBBKKaWUUkopJYQQQiillFJKKaWEEEIopZRSSimllBBCKKWUUkoppZQSQgihlFJKKaWUUkIIpZRSSimllFJKKCGEUkoppZRSSgkllFJKKaWUUkopIZRSSimllFJKKaUAAIADBwCAACPoJKPKImw04cIDEAAAAAIAAkwAgQGCglEIAoQRCAAAAAAACAD4AABICoCIiGjmDA4QEhQWGBocHiAiJAAAAAAAAAAAAAAAAARPZ2dTAATAJAAAAAAAAIuldMYCAAAALeyHaiZZX1taX19lWVtiZWNbYWFfYmNeX2BkY2VeXFxaWGZra2lkYmNaVKIdZqS6FQjUfrKz9b%2FE9o03G59vtjiRWGNm3uuYjfZuTp5Zfog2E1jrwGamgzyv623HyfNCQPpnS0SEOy2c4myN0lFjF5FvUXJFlkimfdiOwbioR3r930oDnh4ypr5nvgLwo5J69U6fPvt578cy2dHb1f4OozknaccubsHNZZMgRX8xvCU%2FxBz6Lau7etbXF6cwxJtHCikbmcu2zAo5jBjporwqk2XJtHSpvhgyiFhj2YL7t8fo6QSiH72Y2eWkAaKn0j298tY%2BjHdMjVZ98jzc3qz%2B9TM1nxikugsqIz%2Bn96tVGj0dCsKoFNJpenDYvb4IJENPuZcOEditCOWv2q7t7PPGuSXuyTTzur%2FiedgGqvhLlh%2BUPHUoQWoKwFf7lY3qu8Rx8%2FyVqVC4cMSaz0dypn7a6DQ6uGBOoKuD4Qll9WvcMWNR1FWsc0ocGLN7bagZHUPOd%2FJpSeLj4h9Jbjb1uwQmS2VYNXaE7ooLlu%2B%2BZqOzbAAHEwB1Aeylnz58Zd2%2BNcv%2BP7Yfc0w8fdUU5ezVbnV%2FHasYQjX9dIzRshlRL28eGE1Vazpx6PQra0bbqLZJdojz4OxEBiNkUEu%2BFfirwMDo5UEb554Y3XCecS%2FkB8DwPgCoCVAKgLz4GXmahuay1c7Ot3pjXZPrCjJ0CX67rf3XC5RPCN4o1UU7ISnrod%2FByvI0PmAiZ69j1P33Mv6NwKl2YdjfNkBp0y4kvvAjfeESTa%2BhOivJMqasAa1mLgBA7QB1gwMQcByUzivrizp7tsmGJ48WxSDMZce%2Ff75yyWf6NGtxKnqLhC5%2BfPe%2Bnj3POZ4tu%2FWxRrXZ5Tbse%2BTTH4%2BR6XgYK%2FrUj6474HA%2FLDGJKLCH4tMYxZ1H5K4GnqmE16dxrrE60MAAGgfcMzX6Pevg%2F2UuwqPB4qjVY5LfrQtkF1vNNXx5NFWzeFxMIPPW10%2Fmt2amDQAxaqz%2Fjm%2FS3rW3S2sAlSB%2B%2FhvmJmQ%2Bx4tQ5B%2F%2BjgOaqDTv7ASfFaCLUHssAHpWJKLsOtGxeq1m3S%2FHvMRp6xc%2F0lknjNaawMDzSt3AFDAw8eap%2Fr9OAjGU5%2FUtYnRij5Sg2YyE9%2B%2F%2FH8cMJUjsjN1qC6ssCVE4iI8ApmoPpU%2BQlaD%2FEAAPAFfgcAwAwPmoiwKr2%2BlM1sLO01QLIDkdGWhPbCWAGE5Ol0qOi%2BXvNpnh12QEhJ7rEwLByIoz%2F3HPVAEPGWD4MBiAjw%2BL%2BgOda5052bL7KB%2FR9%2BKRxQCi7FUplIA9D7AfjIEZFKA2QANoTY1KpFv6I0PefLu7oFjtRdD289l2Pxxat58teK1izsLq4suZScWDtJxBRgtU05TU%2BTwk8vWUowM8lk8D9mbONwwAebOsBnaXh75xFNpu7OVRA6Jsa609EOA8sUQDwwGA78d1wRXLg%2FlKG3vb9A4Q%2FEOnWmO1FxVYRRW%2F89%2BLm9TUxETZvtjSE0aJbkeq6ei33cfvJ9sHzmaQghQBseuf3%2F2EdE4TJbRLnIY5y533KZIpOrJMxKKtQSoPgD5XHYAKEAJ4JN1ovR8OXatwNtnpgdHEdnCaKNBGCs9fPwCJYbk%2FM8bXMkp1IkUeTI1W0iV5p7cP5fVYetfJXTMoh9Frq%2BeCnnz1JYvXJHdCqfs1swKabXcSPYuGzyE5HiYBX4Die3sN1AX%2FfRM2%2B5M5Ia33O5qEOzc9wKgj1Nl%2FfQQPlsnJCClJ1dWDP%2FXc4NZaJ%2BdSP%2F7%2B4oZrit%2FGPsuRYTY3izFxG31WIUIJlahiufbWCyUenqlp%2FvLgSTTovgrrAAGoG8AzW6lbBZ%2BmsdA4NyEc3V7ox79JIPYIPtozFXYVqN4ssG6rVEvd6AAChubVbjdX8vmXEd%2BRzWho1g6fc2Gs0rAo1xtQ5%2FtHRXF%2Bf3%2Bj65xxAJ6pofIyzlUIwDrgaWADp4CC3vGttm4MxvDKq621s%2BnTguokwcM1qJ3XtwOYgK9NluNfzRF9SwguKuUwBq296FHyv0ntJrwSumovUyEvHR5vFdrtiMw2HE7JkOq0V2Y8mqmU10pzoSctARkFs8HhB8b5q1c6gz73e4M%2B%2BTeGd4c%2Fpe3dSRcAQ9gfDWH9ny%2F%2FbfdSwkhc5I7zsyZwMpVHWbJd9jgCyQzNw6tvnv7%2BDrdY1Hrb6qUKFi%2B8uRYP78hZFwKWbVekl4CtKiQ1MAKgA9MCB28zLmdLrwmdv6kuYZ2nDkx8HSBYIvhNKvXcfBXaygBOgjrre6mjB2Y%2FtQCa6Vycd1MT3796zybvmGmAWq4Ghzpuqc7Mnw4YMX9LvRnFFZisFBWSrn38JVZVzQQiBaACpJm4dP%2F5hi5P3p2afvdtjsu9pGvMmWpZvLQtQ8rOrwdEQbIuFS3Z5mZ72haTKZmyxzL3yBwohzkrOZ%2FZbhZmJa0UwSlVLRz1YdbTFGwgrRJwkq0dVLOwg5ppBbDJV1b9vzRqeGitkzs8jYm9ZN1a7NAcO6HPxyPJj9FgXQa5rzBf84mi72cXHYRlkVfX%2BWWIQgKA9k6na%2Bn95YbnzfG7E0%2Fl0jL8%2BU%2F%2B7tR3AJQckgCWLAYyXPAJqADqAQeg%2F8GBp72kP143OHT6tG5vRA1aXr1r0swMO5r5sJa5Y2SXiNcF8exlJ7k6Y%2FFOz9A79JMCcVdxj6y%2B478Bh99SRgIQKG2kp30f5m0%2B19MtHavSrg6WriTroK4IwKCDc2DCg5je5uWWWXcxZ26tqR%2BJePogKndESQClUAn8pmdd31tX3eRFF08NYvxIMfO30aqBntg8N29s%2FvZVdYhh16ME1MvY6Xf0HCJHQLlfPzyPn7NNBLFqDqYNkmw19eEdAagwBhsT1LMvn6bPz7j52Nf6Sr%2BEvl2V7rjEJ5ItZEArq8eLIfzbZ8r1cK4W7y65s9sn1bVLiyGDkX7%2BPfnnF2kOyNuml7rIvMOtREN7JT4YhCkdFvO4%2B1hGsHQMlqtxIDXvzKACsDGwIabbOXShrxr29%2Bz6ntiEky1Zy%2BhwOrnz6yBtz2QvLiuLn3yR%2Fp0l2z5f4QvhS0ANWaxJCqgT%2BzR61lmBTNOHgPTRl0rWUV5kkZDbPO5gKrUtNvCF0jNyhgSWa5bElJcdAN8GpJ9%2B7efLPrdias94vF0W89K1GMfM3dES0WFHi8nDqQGRJ51x2oeYmFnv5DthcKkMYN44DfCz0eWxs3g75M66GrWMXr9fvhU1P1ZbuJ0ffvPDFOQDlqcrjQMAvjoDwH523y9WF8PZXZ1M96R71d9sd05s56bITsXcRE6jrCyXkoerPB4eHw87mCM%2B%2B9bpcuX0OnxteQW5n78U8M2pV1rcOvZmqxMufrDGzvjPZfhAUDSOYda0zNLKpSDURLWv0fj1PXVCVI%2Fc68NmMz%2FSymfmHN%2FFeOh22fzlkixduW3i%2FTyHKyL4zsi8AIN7UmpeElQjadE6VaTX%2BVIuKNnk%2FFRNeuga6u3c5mExsOumAJKhqGAcKABfrcw%2BOXK0bxw%2B%2FPD7dkynjL9VoLJEkajaNIOpJoqCXonujf2tlpzIHDWuxM%2F0Yf2vTHr6%2BqIwyc4oaCdH8QGZXgdeHEfiF7bk6NbG7cXGBFw3N5KkB2qWl4M4psoVa%2FefPV9VT%2F1Kn3ii7ef%2ForAe9JZs9GZkVkewuWcdu0fu40%2FVSknKjD3ckVz5O9vS0zAve5xdhF3H1%2Fs5O80D2%2BG4jcD98%2Fup3MWrhRiWKzbLJzTOQAgQmUCzSC8awED3d758ZuvUza1007WknS2jz%2FYN%2FW2FEhNaWCpK79vl%2Fz39s6%2FSfp38fX0yjQ4JDy1od0CNL%2BeNs7sISCPu18KiHE%2BFBrIBNTbpjGLx7KfXZEjH0ACaLXdwSwDq6hyD4QFAA6QGeJ04XWwl0pSR10nR1Ky0NUzG0Xz2V%2FNVr%2BSQWOWT36lHrC0GIJaPG4vkiYnz559%2FrqccnH3Zu%2BUfc9kZVkbPfmzaJqa9fBUwjUiLtfb29XBTyFGx7sd5FnUjE6KqlPfDolHfPQCD8YX4B2y4QgEQO3ft1%2BWRbWbOB3v3HSbfaDBSIcwFBCG0MEx86368sj1fnrR%2F8PmXdw8ZnQuNQAlVYSzt4yvLarz1z8ky4qEHTn19maeQsDwa84KxJ%2F64q9LQwvTMBLkDmmlXmR5qJCpRAAMbvSuKKlj9lD3y8Z9qvVdUFvfdzcVaKi2qUmgBzUuaJ7P1%2Fer%2B%2FYnP%2F3xf%2FPrn5%2B9X7NKsJ5WGt0PHmm39fPdkBABWh2io0D18J95yxjkI5uTz5fIwG2omTuyEunYflmc%2FpCZYajdg68XhTPj%2BbPuTy%2F80XZ968rZ2NHn%2Fa1loZKnQsTwZ6uzPwbHUy1f%2B6I%2BZNiKiyMfK2W7kbrQ5WbS3IhMavPDG6XDwdnJd7tJe4debdJ3u4XsCjIqlpp6uo%2FKJfZrntVay8QDBhgFb36A4UBUA%2Bveug%2BvWo0pqtrNr9iZqccxxLCfz6fNy7fr%2Ftr%2Bubrb%2Bm9oM6Ph8vnbYdRtY1ypMq95M8VngdIlGGi63yCTXD6fL2SzD3PZ2%2Bv3wCSJbxC4NmuQVo94qAaAAcQCXFJZOQPHT78NUtz4ju6gYxO65NvW9SlBkKaKcNPtQi0ib1FHDo9%2BXl5c9S63m3Mn6TEnH4kgtWjLc76OeZXKLMugZYWoRELvGQ3VGlRwdy9wxAdF5OyQNnqSbTYHTOdBAQHG9yZTZnZ%2B9etfl6OHfz17vdzYkWXi85PDhbQvnxrDuiVT9V9J6Q1jsmAxS5f5ykkI3Z2TYT%2F6vjfmtFv1sKc5sZPAw3dlDKY9Iq1UL0d8AiqI%2BUlkDNWNlbP66dvPf7CZ7h6cnJ81nwUms0vnNAhemuc%2Fjdl0yk5J8eWnzJGzCnQDgGAAyu6gfcxG25bKWS%2Fv%2BbgdXshPqbyn4hgkkJMC4vWQx&success=True&name=TestUpload

note that the value of the data key that is supposed to contain the file is first Base64 encoded and then application/x-www-form-urlencoded such that to be able to decode this file, one must first form-unescape the string and then decode the Base64 string. Using the Linux command line, this would be: 

alias urldecode='sed "s@+@ @g;s@%@\\\\x@g" | xargs -0 printf "%b"'

followed by: 

echo INPUT | urldecode | base64 -d > sound.ogg

where:

  • INPUT is the entire string value of the data key from the download command return.

The file that was downloaded is the following:

The previous command should create the sound.ogg file that can be queried, say with ffprobe: 

Input #0, ogg, from 'sound.ogg':
  Duration: 00:00:00.85, start: 0.000000, bitrate: 59 kb/s
    Stream #0:0: Audio: vorbis, 11025 Hz, mono, fltp, 29 kb/s
    Metadata:
      encoder         : Lavc57.48.101 libvorbis

Now, to perform the converse operation, encode the sound with Base64 and form-escape it in order: 

curl --location --request POST 'http://CORRADE_HTTP_SERVER:CORRADE_HTTP_PORT' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'command=upload' \
--data-urlencode 'group=Wizardry and Steamworks' \
--data-urlencode 'password=...' \
--data-urlencode 'name=FILENAME' \
--data-urlencode 'type=Sound' \
--data-urlencode 'data=T2dnUwACAAAAAAAAAACLpXTGAAAAAFB1DdYBHgF2b3JiaXMAAAAAARErAAAAAAAASHEAAAAAAACZ
AU9nZ1MAAAAAAAAAAAAAi6V0xgEAAAAUVRa2C0D///////////+1A3ZvcmJpcw0AAABMYXZmNTcu
NDEuMTAwAQAAAB8AAABlbmNvZGVyPUxhdmM1Ny40OC4xMDEgbGlidm9yYmlzAQV2b3JiaXMSQkNW
AQAAAQAMUhQhJRlTSmMIlVJSKQUdY1BbRx1j1DlGIWQQU4hJGaV7TyqVWErIEVJYKUUdU0xTSZVS
lilFHWMUU0ghU9YxZaFzFEuGSQklbE2udBZL6JljljFGHWPOWkqdY9YxRR1jUlJJoXMYOmYlZBQ6
RsXoYnwwOpWiQii+x95S6S2FiluKvdcaU+sthBhLacEIYXPttdXcSmrFGGOMMcbF4lMogtCQVQAA
AQAAQAQBQkNWAQAKAADCUAxFUYDQkFUAQAYAgAAURXEUx3EcR5IkywJCQ1YBAEAAAAIAACiO4SiS
I0mSZFmWZVmWpnmWqLmqL/uuLuuu7eq6DoSGrAQAyAAAGIYhh95JzJBTkEkmKVXMOQih9Q455RRk
0lLGmGKMUc6QUwwxBTGG0CmFENROOaUMIghDSJ1kziBLPejgYuc4EBqyIgCIAgAAjEGMIcaQcwxK
BiFyjknIIETOOSmdlExKKK20lkkJLZXWIueclE5KJqW0FlLLpJTWQisFAAAEOAAABFgIhYasCACi
AAAQg5BSSCnElGJOMYeUUo4px5BSzDnFmHKMMeggVMwxyByESCnFGHNOOeYgZAwq5hyEDDIBAAAB
DgAAARZCoSErAoA4AQCDJGmapWmiaGmaKHqmqKqiKKqq5Xmm6ZmmqnqiqaqmqrquqaqubHmeaXqm
qKqeKaqqqaqua6qq64qqasumq9q26aq27MqybruyrNueqsq2qbqybqqubbuybOuuLNu65Hmq6pmm
63qm6bqq69qy6rqy7Zmm64qqK9um68qy68q2rcqyrmum6bqiq9quqbqy7cqubbuyrPum6+q26sq6
rsqy7tu2rvuyrQu76Lq2rsqurquyrOuyLeu2bNtCyfNU1TNN1/VM03VV17Vt1XVtWzNN1zVdV5ZF
1XVl1ZV1XXVlW/dM03VNV5Vl01VlWZVl3XZlV5dF17VtVZZ9XXVlX5dt3fdlWdd903V1W5Vl21dl
WfdlXfeFWbd93VNVWzddV9dN19V9W9d9YbZt3xddV9dV2daFVZZ139Z9ZZh1nTC6rq6rtuzrqizr
vq7rxjDrujCsum38rq0Lw6vrxrHrvq7cvo9q277w6rYxvLpuHLuwG7/t+8axqaptm66r66Yr67ps
675v67pxjK6r66os+7rqyr5v67rw674vDKPr6roqy7qw2rKvy7ouDLuuG8Nq28Lu2rpwzLIuDLfv
K8evC0PVtoXh1XWjq9vGbwvD0jd2vgAAgAEHAIAAE8pAoSErAoA4AQAGIQgVYxAqxiCEEFIKIaRU
MQYhYw5KxhyUEEpJIZTSKsYgZI5JyByTEEpoqZTQSiilpVBKS6GU1lJqLabUWgyhtBRKaa2U0lpq
KbbUUmwVYxAy56RkjkkopbRWSmkpc0xKxqCkDkIqpaTSSkmtZc5JyaCj0jlIqaTSUkmptVBKa6GU
1kpKsaXSSm2txRpKaS2k0lpJqbXUUm2ttVojxiBkjEHJnJNSSkmplNJa5pyUDjoqmYOSSimplZJS
rJiT0kEoJYOMSkmltZJKK6GU1kpKsYVSWmut1ZhSSzWUklpJqcVQSmuttRpTKzWFUFILpbQWSmmt
tVZrai22UEJroaQWSyoxtRZjba3FGEppraQSWympxRZbja21WFNLNZaSYmyt1dhKLTnWWmtKLdbS
UoyttZhbTLnFWGsNJbQWSmmtlNJaSq3F1lqtoZTWSiqxlZJabK3V2FqMNZTSYikptZBKbK21WFts
NaaWYmyx1VhSizHGWHNLtdWUWouttVhLKzXGGGtuNeVSAADAgAMAQIAJZaDQkJUAQBQAAGAMY4xB
aBRyzDkpjVLOOSclcw5CCCllzkEIIaXOOQiltNQ5B6GUlEIpKaUUWyglpdZaLAAAoMABACDABk2J
xQEKDVkJAEQBACDGKMUYhMYgpRiD0BijFGMQKqUYcw5CpRRjzkHIGHPOQSkZY85BJyWEEEIppYQQ
QiillAIAAAocAAACbNCUWByg0JAVAUAUAABgDGIMMYYgdFI6KRGETEonpZESWgspZZZKiiXGzFqJ
rcTYSAmthdYyayXG0mJGrcRYYioAAOzAAQDswEIoNGQlAJAHAEAYoxRjzjlnEGLMOQghNAgx5hyE
ECrGnHMOQggVY845ByGEzjnnIIQQQueccxBCCKGDEEIIpZTSQQghhFJK6SCEEEIppXQQQgihlFIK
AAAqcAAACLBRZHOCkaBCQ1YCAHkAAIAxSjknJaVGKcYgpBRboxRjEFJqrWIMQkqtxVgxBiGl1mLs
IKTUWoy1dhBSai3GWkNKrcVYa84hpdZirDXX1FqMtebce2otxlpzzrkAANwFBwCwAxtFNicYCSo0
ZCUAkAcAQCCkFGOMOYeUYowx55xDSjHGmHPOKcYYc8455xRjjDnnnHOMMeecc845xphzzjnnnHPO
Oeegg5A555xz0EHonHPOOQghdM455xyEEAoAACpwAAAIsFFkc4KRoEJDVgIA4QAAgDGUUkoppZRS
SqijlFJKKaWUUgIhpZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkop
pZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWUUkoppZRSSimllFJKKaWU
UkoplVJKKaWUUkoppZRSSimlACDfCgcA/wcbZ1hJOiscDS40ZCUAEA4AABjDGISMOSclpYYxCKV0
TkpJJTWMQSilcxJSSimD0FpqpaTSUkoZhJRiCyGVlFoKpbRWaymptZRSKCnFGktKqaXWMuckpJJa
S622mDkHpaTWWmqtxRBCSrG11lJrsXVSUkmttdZabS2klFprLcbWYmwlpZZaa6nF1lpMqbUWW0st
xtZiS63F2GKLMcYaCwDgbnAAgEiwcYaVpLPC0eBCQ1YCACEBAAQySjnnnIMQQgghUoox56CDEEII
IURKMeacgxBCCCGEjDHnIIQQQgihlJAx5hyEEEIIIYRSOucghFBKCaWUUkrnHIQQQgillFJKCSGE
EEIopZRSSikhhBBKKaWUUkopJYQQQiillFJKKaWEEEIopZRSSimllBBCKKWUUkoppZQSQgihlFJK
KaWUUkIIpZRSSimllFJKKCGEUkoppZRSSgkllFJKKaWUUkopIZRSSimllFJKKaUAAIADBwCAACPo
JKPKImw04cIDEAAAAAIAAkwAgQGCglEIAoQRCAAAAAAACAD4AABICoCIiGjmDA4QEhQWGBocHiAi
JAAAAAAAAAAAAAAAAARPZ2dTAATAJAAAAAAAAIuldMYCAAAALeyHaiZZX1taX19lWVtiZWNbYWFf
YmNeX2BkY2VeXFxaWGZra2lkYmNaVKIdZqS6FQjUfrKz9b/E9o03G59vtjiRWGNm3uuYjfZuTp5Z
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
bgdXshPqbyn4hgkkJMC4vWQx
'

where:

  • CORRADE_HTTP_SERVER the IP or hostname of the computer running Corrade,
  • CORRADE_HTTP_PORT the port that Corrade opens for HTTP commands,
  • CORRADE_GROUP_PASSWORD the group password for the group,
  • FILENAME the name of the asset that will be created inside Corrade's inventory in-world

Note here that cURL has some nifty command line parameters like --data-urlencode that allow encoding and decode of the Base64 string.

If you wonder why the Base64 string has to be escaped, this is due to key-value pairs being used that will break in case Base64 emits equal signs which is part of its language.

2021/06/10 07:57

Notes

Except for:

all the other assets can be grabbed by Corrade's download command in case the UUID of the item is known.

Textures, sounds and animations are well-known formats that, once received, can be easily reused and converted to something else. On the other hand, clothing, landmarks, gestures, notecards and scripts (LSLText) are Linden-based formats that cannot be converted directly.

Some of these formats, for example Clothing, include references to images which will have to be pulled separately by first retrieving the clothing, going through the file and gathering UUIDs and then issuing another download to fetch the textures.