1 /* sfdb_freesound_mootcher.cpp **********************************************************************
3 Adapted for Ardour by Ben Loftis, March 2008
4 Updated to new Freesound API by Colin Fletcher, November 2011
8 Mootcher Online Access to thefreesoundproject website
9 http://freesound.iua.upf.edu/
12 mail for questions/remarks: mootcher@twistedlemon.nl
13 or go to the freesound website forum
15 -----------------------------------------------------------------
18 curl.h (version 7.14.0)
22 -----------------------------------------------------------------
25 This program is free software; you can redistribute it and/or
26 modify it under the terms of the GNU General Public License
27 as published by the Free Software Foundation; either version 2
28 of the License, or (at your option) any later version.
30 This program is distributed in the hope that it will be useful,
31 but WITHOUT ANY WARRANTY; without even the implied warranty of
32 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
33 GNU General Public License for more details.
35 You should have received a copy of the GNU General Public License
36 along with this program; if not, write to the Free Software
37 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
40 *************************************************************************************/
41 #include "sfdb_freesound_mootcher.h"
43 #include "pbd/xml++.h"
44 #include "pbd/error.h"
47 #include <sys/types.h>
51 #include "pbd/gstdio_compat.h"
55 #include "ardour/audio_library.h"
56 #include "ardour/rc_configuration.h"
57 #include "pbd/pthread_utils.h"
58 #include "gui_thread.h"
62 static const std::string base_url = "http://www.freesound.org/api";
63 static const std::string api_key = "9d77cb8d841b4bcfa960e1aae62224eb"; // ardour3
65 //------------------------------------------------------------------------
67 : curl(curl_easy_init())
69 cancel_download_btn.set_label (_("Cancel"));
70 progress_hbox.pack_start (progress_bar, true, true);
71 progress_hbox.pack_end (cancel_download_btn, false, false);
73 cancel_download_btn.show();
74 cancel_download_btn.signal_clicked().connect(sigc::mem_fun (*this, &Mootcher::cancelDownload));
76 //------------------------------------------------------------------------
77 Mootcher:: ~Mootcher()
79 curl_easy_cleanup(curl);
82 //------------------------------------------------------------------------
84 void Mootcher::ensureWorkingDir ()
86 std::string p = ARDOUR::Config->get_freesound_download_dir();
88 if (!Glib::file_test (p, Glib::FILE_TEST_IS_DIR)) {
89 if (g_mkdir_with_parents (p.c_str(), 0775) != 0) {
90 PBD::error << "Unable to create Mootcher working dir" << endmsg;
94 #ifdef PLATFORM_WINDOWS
95 std::string replace = "/";
96 size_t pos = basePath.find("\\");
97 while( pos != std::string::npos ){
98 basePath.replace(pos, 1, replace);
99 pos = basePath.find("\\");
105 //------------------------------------------------------------------------
106 size_t Mootcher::WriteMemoryCallback(void *ptr, size_t size, size_t nmemb, void *data)
108 int realsize = (int)(size * nmemb);
109 struct MemoryStruct *mem = (struct MemoryStruct *)data;
111 mem->memory = (char *)realloc(mem->memory, mem->size + realsize + 1);
114 memcpy(&(mem->memory[mem->size]), ptr, realsize);
115 mem->size += realsize;
116 mem->memory[mem->size] = 0;
122 //------------------------------------------------------------------------
124 std::string Mootcher::sortMethodString(enum sortMethod sort)
126 // given a sort type, returns the string value to be passed to the API to
127 // sort the results in the requested way.
130 case sort_duration_desc: return "duration_desc";
131 case sort_duration_asc: return "duration_asc";
132 case sort_created_desc: return "created_desc";
133 case sort_created_asc: return "created_asc";
134 case sort_downloads_desc: return "downloads_desc";
135 case sort_downloads_asc: return "downloads_asc";
136 case sort_rating_desc: return "rating_desc";
137 case sort_rating_asc: return "rating_asc";
142 //------------------------------------------------------------------------
143 void Mootcher::setcUrlOptions()
145 // basic init for curl
146 curl_global_init(CURL_GLOBAL_ALL);
147 // some servers don't like requests that are made without a user-agent field, so we provide one
148 curl_easy_setopt(curl, CURLOPT_USERAGENT, "libcurl-agent/1.0");
149 // setup curl error buffer
150 curl_easy_setopt(curl, CURLOPT_ERRORBUFFER, errorBuffer);
152 curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1);
154 // Allow connections to time out (without using signals)
155 curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
156 curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 30);
161 std::string Mootcher::doRequest(std::string uri, std::string params)
164 struct MemoryStruct xml_page;
165 xml_page.memory = NULL;
169 curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteMemoryCallback);
170 curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &xml_page);
172 // curl_easy_setopt(curl, CURLOPT_HTTPGET, 1);
173 // curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postMessage.c_str());
174 // curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, -1);
177 std::string url = base_url + uri + "?";
179 url += params + "&api_key=" + api_key + "&format=xml";
181 url += "api_key=" + api_key + "&format=xml";
184 curl_easy_setopt(curl, CURLOPT_URL, url.c_str() );
186 // perform online request
187 CURLcode res = curl_easy_perform(curl);
189 error << string_compose (_("curl error %1 (%2)"), res, curl_easy_strerror(res)) << endmsg;
194 if (xml_page.memory) {
195 result = xml_page.memory;
198 free (xml_page.memory);
199 xml_page.memory = NULL;
206 std::string Mootcher::searchSimilar(std::string id)
208 std::string params = "";
210 params += "&fields=id,original_filename,duration,filesize,samplerate,license,serve";
211 params += "&num_results=100";
213 return doRequest("/sounds/" + id + "/similar", params);
216 //------------------------------------------------------------------------
218 std::string Mootcher::searchText(std::string query, int page, std::string filter, enum sortMethod sort)
220 std::string params = "";
224 snprintf(buf, 23, "p=%d&", page);
228 char *eq = curl_easy_escape(curl, query.c_str(), query.length());
229 params += "q=\"" + std::string(eq) + "\"";
233 char *ef = curl_easy_escape(curl, filter.c_str(), filter.length());
234 params += "&f=" + std::string(ef);
239 params += "&s=" + sortMethodString(sort);
241 params += "&fields=id,original_filename,duration,filesize,samplerate,license,serve";
242 params += "&sounds_per_page=100";
244 return doRequest("/sounds/search", params);
247 //------------------------------------------------------------------------
249 std::string Mootcher::getSoundResourceFile(std::string ID)
252 std::string originalSoundURI;
253 std::string audioFileName;
257 // download the xmlfile into xml_page
258 xml = doRequest("/sounds/" + ID, "");
261 doc.read_buffer( xml.c_str() );
262 XMLNode *freesound = doc.root();
264 // if the page is not a valid xml document with a 'freesound' root
265 if (freesound == NULL) {
266 error << _("getSoundResourceFile: There is no valid root in the xml file") << endmsg;
270 if (strcmp(doc.root()->name().c_str(), "response") != 0) {
271 error << string_compose (_("getSoundResourceFile: root = %1, != response"), doc.root()->name()) << endmsg;
275 XMLNode *name = freesound->child("original_filename");
277 // get the file name and size from xml file
280 audioFileName = Glib::build_filename (basePath, ID + "-" + name->child("text")->content());
282 //store all the tags in the database
283 XMLNode *tags = freesound->child("tags");
285 XMLNodeList children = tags->children();
286 XMLNodeConstIterator niter;
287 std::vector<std::string> strings;
288 for (niter = children.begin(); niter != children.end(); ++niter) {
289 XMLNode *node = *niter;
290 if( strcmp( node->name().c_str(), "resource") == 0 ) {
291 XMLNode *text = node->child("text");
293 // std::cerr << "tag: " << text->content() << std::endl;
294 strings.push_back(text->content());
298 ARDOUR::Library->set_tags (std::string("//")+audioFileName, strings);
299 ARDOUR::Library->save_changes ();
303 return audioFileName;
306 int audioFileWrite(void *buffer, size_t size, size_t nmemb, void *file)
308 return (int)fwrite(buffer, size, nmemb, (FILE*) file);
311 //------------------------------------------------------------------------
314 Mootcher::threadFunc() {
317 res = curl_easy_perform (curl);
319 curl_easy_setopt (curl, CURLOPT_NOPROGRESS, 1); // turn off the progress bar
321 if (res != CURLE_OK) {
322 /* it's not an error if the user pressed the stop button */
323 if (res != CURLE_ABORTED_BY_CALLBACK) {
324 error << string_compose (_("curl error %1 (%2)"), res, curl_easy_strerror(res)) << endmsg;
326 remove ( (audioFileName+".part").c_str() );
328 rename ( (audioFileName+".part").c_str(), audioFileName.c_str() );
329 // now download the tags &c.
330 getSoundResourceFile(ID);
337 Mootcher::doneWithMootcher()
340 // update the sound info pane if the selection in the list box is still us
341 sfb->refresh_display(ID, audioFileName);
343 delete this; // this should be OK to do as long as Progress and Finished signals are always received in the order in which they are emitted
347 freesound_download_thread_func(void *arg)
349 Mootcher *thisMootcher = (Mootcher *) arg;
352 // std::cerr << "freesound_download_thread_func(" << arg << ")" << std::endl;
353 res = thisMootcher->threadFunc();
355 thisMootcher->Finished(); /* EMIT SIGNAL */
360 //------------------------------------------------------------------------
362 bool Mootcher::checkAudioFile(std::string originalFileName, std::string theID)
366 audioFileName = Glib::build_filename (basePath, ID + "-" + originalFileName);
368 // check to see if audio file already exists
369 FILE *testFile = g_fopen(audioFileName.c_str(), "r");
371 fseek (testFile , 0 , SEEK_END);
372 if (ftell (testFile) > 256) {
377 // else file was small, probably an error, delete it
379 remove( audioFileName.c_str() );
385 bool Mootcher::fetchAudioFile(std::string originalFileName, std::string theID, std::string audioURL, SoundFileBrowser *caller)
389 audioFileName = Glib::build_filename (basePath, ID + "-" + originalFileName);
394 // now download the actual file
395 theFile = g_fopen( (audioFileName + ".part").c_str(), "wb" );
401 // create the download url
402 audioURL += "?api_key=" + api_key;
405 curl_easy_setopt(curl, CURLOPT_URL, audioURL.c_str() );
406 curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, audioFileWrite);
407 curl_easy_setopt(curl, CURLOPT_WRITEDATA, theFile);
410 prog = string_compose (_("%1"), originalFileName);
411 progress_bar.set_text(prog);
413 Gtk::VBox *freesound_vbox = dynamic_cast<Gtk::VBox *> (caller->notebook.get_nth_page(2));
414 freesound_vbox->pack_start(progress_hbox, Gtk::PACK_SHRINK);
415 progress_hbox.show();
416 cancel_download = false;
419 curl_easy_setopt (curl, CURLOPT_NOPROGRESS, 0); // turn on the progress bar
420 curl_easy_setopt (curl, CURLOPT_PROGRESSFUNCTION, progress_callback);
421 curl_easy_setopt (curl, CURLOPT_PROGRESSDATA, this);
423 Progress.connect(*this, invalidator (*this), boost::bind(&Mootcher::updateProgress, this, _1, _2), gui_context());
424 Finished.connect(*this, invalidator (*this), boost::bind(&Mootcher::doneWithMootcher, this), gui_context());
425 pthread_t freesound_download_thread;
426 pthread_create_and_store("freesound_import", &freesound_download_thread, freesound_download_thread_func, this);
434 Mootcher::updateProgress(double dlnow, double dltotal)
437 double fraction = dlnow / dltotal;
438 // std::cerr << "progress idle: " << progress->bar->get_text() << ". " << progress->dlnow << " / " << progress->dltotal << " = " << fraction << std::endl;
439 if (fraction > 1.0) {
441 } else if (fraction < 0.0) {
444 progress_bar.set_fraction(fraction);
449 Mootcher::progress_callback(void *caller, double dltotal, double dlnow, double /*ultotal*/, double /*ulnow*/)
451 // It may seem curious to pass a pointer to an instance of an object to a static
452 // member function, but we can't use a normal member function as a curl progress callback,
453 // and we want access to some private members of Mootcher.
455 Mootcher *thisMootcher = (Mootcher *) caller;
457 if (thisMootcher->cancel_download) {
461 thisMootcher->Progress(dlnow, dltotal); /* EMIT SIGNAL */