Download
Latest Update
2016-04-14 - Added @Kadauchi's fix for the "Watch this HIT" button not showing up after accepting a HIT
-------
Hey all! This tutorial is surely in need of improvements, but something is better than nothing. If you don't feel like reading the whole thing, at least take note of these 2 important points:
1) The dashboard must be open in a tab at all times for Turkmaster to work correctly. It's not optimal, but that's how it works (for now). A lot of people miss this point and run into trouble.
2) Back up your watchers on a regular basis. There is some weird bug that I haven't tracked down that can make you lose all of your watchers when you least expect it. This has happened to me multiple times (so don't feel alone) and was why I added the backup feature in the first place.
This list may grow in the future, but those are the 2 things I feel that everyone with the script should know before they even start using Turkmaster. Now on to the details...
How It Works
When you first install the script, you'll notice a list of "watchers" on the dashboard. Again, the dashboard must always be open in a tab for the script to work. The first Play button at the top starts all of the watchers in your list. Under each of the watchers' play button there is a check box. You can select certain watchers and use the second Play button at the top (the one with the square) to only start those watchers. The Pause button at the top stops all watchers.
There are 3 types of watchers: Requester, URL, and HIT. Depending on the type of watcher there are a few options such as sounding an alert like PageMonitor and auto-accepting a HIT. When auto-accept is on you have an option to make it stop after catching a HIT (useful for surveys) or you can let it continue to auto-accept for batches.
To add a watcher go to a search page, requester page, or HIT and you'll see a button to add a watcher for the page.
Clicking the button will bring up a form for you to give the watcher a name, set the interval time, and choose various options.
Clicking the Save button will save the watcher to your dashboard and will begin running immediately. Note the watcher with the blue highlight. The blue highlight means that particular watcher is running.
Here's an example of a notification for surveys 75 cents and up. You can preview or accept a HIT directly from a notification. The "+auto" button will accept the HIT and select the check box to auto-accept the next HIT. Click on 'mute' if a notification comes up that you don't want receive a notification for. This only mutes individual HITs. To ignore a requester, hover over the requester's name and click on the "ignore" link that shows up.
Things You Should Know
For this script to work properly you will always need to have the dashboard open in a tab and it'll only run in a single dashboard tab. The script will disable itself in any other dashboard tabs if it's already open in an existing tab. It had to be done like this because of the way the tabs communicate with each other.
The notifications shown above will only show on Mturk pages. However, if you want to see the notification while browsing a forum, Reddit, or doing anything else, there is an option for desktop notifications. You won't be able to preview or accept HITs with those notifications, but clicking on them will bring the dashboard to the foreground with the notification highlighted (I've heard that this doesn't work for some people anymore on Chrome - I have to look into it) so you can accept from there.
Enjoy!
Donovan
Past Updates
2016-04-11 - Added @Kerek's hotfix for the missing "Watch this HIT" button caused by changes to mturk. Thanks @Kadauchi!
2015-10-17 - Fixed an issue with playing sound on Chrome (still unsure why the old code stopped working)
2015-08-18 - Added the ability to mute a panda watcher after the first HIT is caught (for those that don't want to keep hearing the sound afterwards)
2015-08-09 - Added an option to disable the stop on captcha feature. Also changed the colors for running and updated watchers so they stand out more.
2015-04-02 - Changed TO servers (wow, it's been a while!)
2014-11-06 - Quickfix for Turkmaster elements disappearing
2014-10-22 - Updated Turkoption URL to new proxy. Thanks Miku! Oh and fixed a typo, too. Thanks spamhead.
2014-10-12 - Fixed issue with watchers not loading. Also no longer loading external resources from non-https sites.
2014-10-09 - Watchers and user settings should persist after clearing browser history. Settings changes should save immediately. TO has cached ratings and other fixes. Other minor bugs were fixed, as well.
2014-09-26 - Added the ability to export and import watchers
2014-09-21 - Added the ability to hide the watcher list to save space. Last seen hits are remembered after the page is reloaded.
2014-09-21 - Added TO links, chart and color coding
2014-09-07 - Added the ability to ignore requesters. Hits from ignored requesters won't show up in notifications and will be faded out on the dashboard list.
Latest Update
2016-04-14 - Added @Kadauchi's fix for the "Watch this HIT" button not showing up after accepting a HIT
-------
Hey all! This tutorial is surely in need of improvements, but something is better than nothing. If you don't feel like reading the whole thing, at least take note of these 2 important points:
1) The dashboard must be open in a tab at all times for Turkmaster to work correctly. It's not optimal, but that's how it works (for now). A lot of people miss this point and run into trouble.
2) Back up your watchers on a regular basis. There is some weird bug that I haven't tracked down that can make you lose all of your watchers when you least expect it. This has happened to me multiple times (so don't feel alone) and was why I added the backup feature in the first place.
This list may grow in the future, but those are the 2 things I feel that everyone with the script should know before they even start using Turkmaster. Now on to the details...
How It Works
When you first install the script, you'll notice a list of "watchers" on the dashboard. Again, the dashboard must always be open in a tab for the script to work. The first Play button at the top starts all of the watchers in your list. Under each of the watchers' play button there is a check box. You can select certain watchers and use the second Play button at the top (the one with the square) to only start those watchers. The Pause button at the top stops all watchers.
There are 3 types of watchers: Requester, URL, and HIT. Depending on the type of watcher there are a few options such as sounding an alert like PageMonitor and auto-accepting a HIT. When auto-accept is on you have an option to make it stop after catching a HIT (useful for surveys) or you can let it continue to auto-accept for batches.
To add a watcher go to a search page, requester page, or HIT and you'll see a button to add a watcher for the page.
Clicking the button will bring up a form for you to give the watcher a name, set the interval time, and choose various options.
Clicking the Save button will save the watcher to your dashboard and will begin running immediately. Note the watcher with the blue highlight. The blue highlight means that particular watcher is running.
Here's an example of a notification for surveys 75 cents and up. You can preview or accept a HIT directly from a notification. The "+auto" button will accept the HIT and select the check box to auto-accept the next HIT. Click on 'mute' if a notification comes up that you don't want receive a notification for. This only mutes individual HITs. To ignore a requester, hover over the requester's name and click on the "ignore" link that shows up.
Things You Should Know
For this script to work properly you will always need to have the dashboard open in a tab and it'll only run in a single dashboard tab. The script will disable itself in any other dashboard tabs if it's already open in an existing tab. It had to be done like this because of the way the tabs communicate with each other.
The notifications shown above will only show on Mturk pages. However, if you want to see the notification while browsing a forum, Reddit, or doing anything else, there is an option for desktop notifications. You won't be able to preview or accept HITs with those notifications, but clicking on them will bring the dashboard to the foreground with the notification highlighted (I've heard that this doesn't work for some people anymore on Chrome - I have to look into it) so you can accept from there.
Enjoy!
Donovan
Past Updates
2016-04-11 - Added @Kerek's hotfix for the missing "Watch this HIT" button caused by changes to mturk. Thanks @Kadauchi!
2015-10-17 - Fixed an issue with playing sound on Chrome (still unsure why the old code stopped working)
2015-08-18 - Added the ability to mute a panda watcher after the first HIT is caught (for those that don't want to keep hearing the sound afterwards)
2015-08-09 - Added an option to disable the stop on captcha feature. Also changed the colors for running and updated watchers so they stand out more.
2015-04-02 - Changed TO servers (wow, it's been a while!)
2014-11-06 - Quickfix for Turkmaster elements disappearing
2014-10-22 - Updated Turkoption URL to new proxy. Thanks Miku! Oh and fixed a typo, too. Thanks spamhead.
2014-10-12 - Fixed issue with watchers not loading. Also no longer loading external resources from non-https sites.
2014-10-09 - Watchers and user settings should persist after clearing browser history. Settings changes should save immediately. TO has cached ratings and other fixes. Other minor bugs were fixed, as well.
2014-09-26 - Added the ability to export and import watchers
2014-09-21 - Added the ability to hide the watcher list to save space. Last seen hits are remembered after the page is reloaded.
2014-09-21 - Added TO links, chart and color coding
2014-09-07 - Added the ability to ignore requesters. Hits from ignored requesters won't show up in notifications and will be faded out on the dashboard list.
Last edited: