FAQ Meta Search

From VuzeWiki
Jump to: navigation, search

Vuze® Default Meta Search Templates

By default Vuze searches a limited set of torrent sites. This feature, whereby Vuze has enabled a select few search templates of a limited set of torrent sites, is provided as a convenience to Vuze users. Vuze does not have any relationship with the underlying sites and cannot attest to the legitimacy, safety or completeness of any content that may be identified through such services. Vuze selected and selects these torrent sites because it has a good faith and reasonable belief that those sites track or host content, the overwhelming majority of which content does not infringe upon the rights, including copyright, of any third party. Vuze attempts to determine the legitimacy and legality of these sites -- regarding those sites mostly or exclusively involving non-infringing content -- based upon news reports, outcomes of lawsuits or governmental actions against those sites, as well as periodically examining the number of take-down requests received by Google for domains alleged to be associated with infringing content. (See, Google Transparency Report, and we encourage you to read Google's official blogs about its Transparency report.) Vuze recognizes that simply because Google might receive a lot of take-down requests associated with a domain that does not necessarily mean that there is a lot of infringing content available on or through such sites, because take-down requests are simply allegations of infringement, not proof that there was or is infringement, many take-down requests are false, abusive, do not take into account "fair use" under the United States Copyright Act and analogous laws of other territories or countries, and might even be based upon falsified court orders. Further, there are reports that many take-down request involve attempts to suppress political speech. However, if Vuze becomes aware of an exceptionally high number of take-down requests associated with a domain that has been in existence for a reasonable period of time Vuze will typically not include, or will remove, such site from its pre-selected search templates.

Vuze users assume, and Vuze disclaims, all risks including of using those templates. To the extent that some Vuze users have occasionally received or might occasionally receive notices from ISPs regarding the downloading of allegedly unlawful copies of content, Vuze believe these arise from the downloading of content outside the Vuze HD Network. It is each user's responsibility to ensure that they are only downloading lawful and non-infringing content -- wherever it may be found. One such source of lawful content is the Vuze HD Network. In any event, Vuze strongly urges each user to act responsibly when it comes to downloading and sharing content. Read more here.

Adding a Search Template to Vuze Meta Search

By default Vuze searches a limited set of torrent sites, however you can also add your favorite torrent sites to Vuze’s meta-search by adding additional search templates. These torrent sites commonly refer to these templates as a “Vuze Search Template”, and you may search online to find additional torrent sites that allow using the Vuze search template. There are many torrent sites that are believed to host or link to a significant amount of content that allegedly infringes upon the rights of others, including copyright, or that contains a lot of "adult" content. It is each user's responsibility to ensure that they are only downloading lawful and non-infringing content -- wherever it may be found. Vuze encourages its users to review this section and to read more here.

Adding a Search Template to Vuze Meta-Search:

1. On the search results page, click the “Add/edit” link under “Show results from” on the right-side of the page
Ms addedit.png
2. On the Add/edit pop-up, click the “Import a new template” link at the bottom of the list of searched sites.
Ms addedit dialog.png
3. Browse your computer to find and select the custom template file (similar to when you upload a photo to a website).

Once you select the custom template file it will automatically import the template and add it to the bottom of the list of searched sites.

Keep in mind that custom templates are community created, so we have no control over how they are named or created, and cannot insure that they work properly, if at all.

Here's an example search template for Mininova if you want to try the process: Mininova Search Template

  • Please Note: Search results on Vuze are drawn from multiple sites across the web. The content may or may not comply with copyright laws in your territory, and Vuze is not responsible for content you may download.

Copying Search Templates from one computer to another

If you want to transfer search templates that you have installed on one copy of Vuze to another

  • On the first computer export the templates by right-clicking on the toolbar area in the Vuze client (the bit at the top with the search box, download/play/move buttons - pick the right-hand-side of the toolbar to get this menu) and select the 'Export all Search Templates' option. This allows you to save them all to a .vuze file, let's say you called it 'templates.vuze'
  • Copy 'templates.vuze' to the other computer (if you have a shared network then you can just copy it over, otherwise you could use a USB stick etc).
  • On the other computer double click the 'templates.vuze' file, or open it via the 'File->Open Vuze File' menu option - this will install the templates.


If you don't have a running version of Vuze to copy from, but you do have a backup, you can copy the search templates by locating the "metasearch.config" file and copying that to the Vuze user configuration data directory. Make sure Vuze isn't running when you do this.

What is a custom template?

We offer an advanced function, which enables you to search and return results from other sites using “custom templates.” A “custom template” is a small file containing text instructions that you can import into your Vuze application that enables you to return results from sites other than Vuze. Once imported, the “custom template” will add an additional site to the list of sites searched using your Vuze search box. Custom templates are created by the Vuze community and can be configured to enable search of any content found on the web. There are many custom templates that search and return results from other torrent sites that are believed to host or link to a significant amount of content that allegedly infringes upon the rights of others, including copyright, or that contains a lot of "adult" content. It is each user's responsibility to ensure that they are only downloading lawful and non-infringing content -- wherever it may be found. Vuze encourages its users to review this section and to read more here.

Where do I find custom templates?

Custom templates are created by users and can be used to search any content found on the web. Vuze does not review, approve or manage custom templates. As our community uses our new search functionality, we imagine some users will create custom templates for their own use or sharing with others, and that they will find creative and convenient ways to share them with others. There are many custom templates that search and return results from other torrent sites that are believed to host or link to a significant amount of content that allegedly infringes upon the rights of others, including copyright, or that contains a lot of "adult" content. It is each user's responsibility to ensure that they are only downloading lawful and non-infringing content -- wherever it may be found. Vuze encourages its users to review this section and to read more here.

Who should create custom templates?

Custom template capabilities were created with advanced users in mind.

How do I create a custom template?

Creating a custom template is non-trivial. As a minimum, you need to be comfortable with "regular expression" or JSON. You also need to be comfortable with reading HTML source code. If this describes you, then the following instructions may be helpful for you:

Vuze supports two kinds of custom search templates. The most common is "regular expression," which matches against the source code of a search results page. The second type, JSON, is for sites which provide data in JSONformat.

To create a regular expression template:

1) After clicking "Create a custom template" at the bottom of the "Add/edit" dialog, make sure "regular expression" is selected, and click "Continue."

2) Give your template a name, then use your browser to do a search on the site you're making the template for. Copy the URL into "URL to search," and replace your query term with "%s".

3) "Preview search term" can be any search keyword that gives multiple results. This must be filled in to get to step 5 (where you select which fields to show in the final search results).

4) Begin writing your regular expression by using your browser to View Source for a search on the external site. Find the HTML code for one search result, and copy it into the template editor. Then, replace every dynamic part of the code with a regular expression. You can test your regular expression with online tools. Note that prior to Vuze 4703 there is a bug regarding matching across line breaks (or 'dotall' mode) - the editor will match across them but when Vuze executes the expression itself it fails.

For parts that contain useful information, put capture brackets () around the expression. You can also click "Preview matches" to see which parts of the HTML code are matched by your regular expression.

5) When you're done, click "continue" to see the first five matches for your preview term. Use the menus to select what each of the captured fields represents, then click "Save and finish".

6) The template is now ready for use on your machine. To share it with others, click the "Export as file" button. This gives you a .vuze file that you can publish on a blog or website, and other people can import it by clicking "Add/Edit" from the search page.

Can I just edit an existing search template to make simple changes?

Sometimes you may have a search template that breaks due to some simple change, for example the search URL might change location. To fix these kinds of issues there is a relatively straight forward approach - you will however need to install the latest version of Vuze (See the Beta Program directions for how to obtain this). The steps are as follows

1) Perform a search for something random (in this example 'Big Buck Bunny') - the point of this is to get the search results window to display:

STEdit Search.png

2) Right-click on the search result entry in the Side Bar to show the context menu, then navigate to the template you want to edit (in this example Mininova) and select the 'Copy to clipboard' option.

3) Open a text editor (for example Notepad++) and paste the clipboard contents into it. You will see the content of the search template in JSON format, which is relatively easy to edit. Here's the start of the Mininova template:

{"vuze":{"components":[{"content":{"web.dl_link_css":"23download a!!0","l1_map":[{"from":6,"to":6,"maps":[]}],"l2_map":[{"from":6,"to":8,"maps":[{"from":"Movies","to":"video"},{"from":"TV Shows","to":"video"},{"from":"Anime","to":"video"},{"from":"Music","to":"audio"},{"from":"Games","to":"game"}]}],"web.needs_auth":0,"web.auto_date":1,"web.time_zone":"GMT+1","web.required_cookies":[],"web.search_url_format":"http:\/\/www.mininova.org\/vuze.php?search=%s","json.path":"results","rank_bias":"1.0","select_rec":1,"name":"Mininova",

4) Make your edits - for example if you wanted to change the name of the template you would amend the "name":"Mininova" entry. To modify the search URL you would amend the "web.search_url_format":"http:\/\/www.mininova.org\/vuze.php... portion (make sure you keep the escape characters before any '/')

5) Look for and update the "version", "id" and "uid" entries as required. If you just want to create a new version of an existing template then increment the "version" entry and leave the "id" alone. If you want to create a completely new template then set the "version" to 1 and remove the "id" and "uid" fields completely (make sure you remove the whole "id":<number>, and "uid":"<string>", sections including the trailing commas)

6) Save the resulting text as a .vuze file

7) Test by loading the template into Vuze (drag+drop it onto Vuze / double click it / Use the File->Open->Vuze File... option) and performing searches

Removing a Search Template from Vuze Meta Search

Normally search templates can be configured via the "add/edit" link on the search results page, but occasionally there are issues with this due to browser errors.

Up until Vuze_4703_B23 the manual process to remove a template is as follows:

1) save any custom templates that you want to keep - perform a random search then right click on the entry that appears in the side bar for the search results. There is a menu that gives options to save individual templates or all as a set (although the 'all' option creates a single file that contains everything, so you can't import them individually from this) - you can also export them all by right-clicking on the toolbar area

2) work out where the config directory is for vuze (e.g. go to tools->options->plugins, browse to the per-user plugin directory and go to its parent) - the config dir will have files 'metasearch.config, and possibly metasearch.config.bak.

3) close Vuze

4) delete the metasearch.config (.bak if there) files

5) start Vuze

6) import any templates you wanted to keep

From Vuze_4703_B24 onwards there is a menu option when you right-click on the search entry in the sidebar to delete a template.

Why can't I increase the file size range in the search results?

The file size range isn't the problem, it's a lack of results. The file size range is based on the torrent sizes returned when searching sites via their search template. Currently (Vuze 4.6.0.4) searches the Vuze and Mininova sites via the default search templates. If a search for video x returns results where the largest torrent is 50MB then that is the maximum size that will be seen in the file size range. If the largest file is significantly smaller than what you expected you probably need to consider adding more search templates for other sites.

Download links in search results aren't working

Occasionally you may have issues with the download buttons/links in search results. Your default browser is used to display the results within Vuze and Vuze relies on the browser correctly forwarding download clicks to Vuze to handle the action. If this stops working (for example another application takes control of the action) you can always open the search result in an external browser and proceed from there.

To do this you first need to get to the search result detail page by clicking on the result link shown below:

Metasearch cdplink.png

Then you need to click on the link highlighted to open the page in an external browser.

Metasearch cdpext.png

Vuze crashes when I try to add downloads from search results

This is an issue known to occur on Windows. Unfortunately there is an issue with Internet Explorer (we embed IE into Vuze to display search results) whereby IE crashes when rendering certain web pages. We have no control over this and can't fix it unfortunately. A work around is to use the same approach detailed above for when download links aren't working - open the search details in an external browser rather than browsing within Vuze.

We are considering always opening the search results in an external browser as a solution to this problem, but we'd rather Microsoft fixed their bug!


I purchased Vuze Plus but I am still seeing ads when I search. Is something wrong?

With Vuze Plus, you get ad-free searching for as long as you’re a member, so your searches should be entirely ad-free. Keep in mind, Vuze’s search tool is a meta-search tool, which means that it searches other torrent sites and returns results from those pages to you. When you first see your search results in Vuze, you should see only a list of torrents along with their age, size, rank and the site each torrent is located on or linked from. On this page (a.k.a. the results page) you should absolutely not see any ads after you have upgraded to Plus. However, if you click on any of the results on these pages, you will be taken to that search site, and it will likely have ads on it. We cannot do anything to prevent this. To avoid this, on many of the results, you can simply click the direct download button next to the torrent rather than clicking through to the site itself.

If you are certain that you are seeing ads on the search results page in Vuze Plus, then something has gone wrong. Don’t fret, this happens from time to time. We are well equipped to handle this. Please visit the Vuze Plus support page and follow the directions to send us a message about your problem.

Important Rights & Use Note

Vuze stresses that it respect the rights of copyright holders, and hopes and expects that you do too. Any use of Vuze® or Vuze+™ that violates an intellectual property right or any right of a third party is not allowed. Please do not infringe upon copyright. Content available through Vuze® or Vuze+™ may or may not comply with laws, including copyright laws, in your territory or country, and Vuze is not responsible for content you may download or upload. Read more here and here. Vuze encourages its users to review this FAQ section. Plus, if you are a Vuze user don't forget that you agreed to its Terms.