diff --git a/include/import-dialog.html b/include/import-dialog.html index 3fb1d81..3c0b7bd 100644 --- a/include/import-dialog.html +++ b/include/import-dialog.html @@ -125,3 +125,107 @@ versus Linking for details.

+

Importing from FreeSound.org

+ +

+ Ardour can import sounds from the public library at FreeSound.org. + This feature requires an account with the online service. +

+ +

+ Sound clips on FreeSound.org typically have metadata in form of tags + that give a general idea what sound is recorded in a clip. Ardour will + use that metadata to find sound clips that match your request. +

+ +
+ List of sound clips found on FreeSound.org +
+ List of sound clips found on FreeSound.org +
+
+ +

+ There are two more options for the search: +

+ +
    +
  1. Sort: allows sorting all sound clips that match your + request in a particular order. Changing the type of sorting requires + running the search again.
    2. +
  2. License: allows limiting your search by choosing + a particular license depending on how you license your own work.
    3. +
+ +

+ Ardour will list all sounds clips that match your request right in the + window. If there are a lot of option, click the + More button to load the next page with results. +

+ +

+ When you click on any sound clip in the list for the first time, + a FreeSound.org login page will open in your preferred web browser. +

+ +
+ Log into FreeSound.org +
+ Log into FreeSound.org +
+
+

+ +

+ You will then be asked to grant access to Ardour. +

+ +
+ Grant access to Ardour +
+ Grant access to Ardour +
+
+

+ +

+ Once you do that, FreeSound.org will generate authorization code that you need to select and copy to the clipboard. +

+ +
+ Authorization token +
+ Authorization code +
+
+

+ +

+ Finally, insert the code into the entry box here and click OK. +

+ +
+ Insert authorization token +
+ Insert authorization code +
+
+

+ +

+ After that, Ardour will be able to download clips for preview in a folder + for temporary files that you can select in the + Preferences dialog on the + General page. +

+ +

+ You can preview and insert clips from FreeSound.org like any other sound + files. +

+ +

+ Please note that authorization code only works as long as Ardour is running. + The next time you start Ardour, you will need to authorize it again. This is + implementation specifics of FreeSound.org. +

diff --git a/source/images/freesound-auth-code.png b/source/images/freesound-auth-code.png new file mode 100644 index 0000000..4a128f5 Binary files /dev/null and b/source/images/freesound-auth-code.png differ diff --git a/source/images/freesound-clips-list.png b/source/images/freesound-clips-list.png new file mode 100644 index 0000000..8348e96 Binary files /dev/null and b/source/images/freesound-clips-list.png differ diff --git a/source/images/freesound-code-insert.png b/source/images/freesound-code-insert.png new file mode 100644 index 0000000..5be8e7e Binary files /dev/null and b/source/images/freesound-code-insert.png differ diff --git a/source/images/freesound-grant-access.png b/source/images/freesound-grant-access.png new file mode 100644 index 0000000..75e58a6 Binary files /dev/null and b/source/images/freesound-grant-access.png differ diff --git a/source/images/freesound-login.png b/source/images/freesound-login.png new file mode 100644 index 0000000..6882461 Binary files /dev/null and b/source/images/freesound-login.png differ