Quake Live Hook Manager (QLHM)

IMPORTANT: To download hook.js, see the Version History wiki page.

What QLHM is

• A client-side hook.js file used to allow many userscripts to run in the standalone QUAKE LIVE client
• A server-side node.js application which provides a JSONP interface to manage (i.e. retrieve, cache, check for updates) scripts from userscripts.org

NOTE: The vast majority of users will only need the hook.js script. Refer to the Installation section.

What QLHM is not

• A perfect replacement for a proper userscript engine (e.g. Scriptish, Greasemonkey)

TODO

• A lot... this is a very early release, so expect major issues and breaking changes.

Want to contribute/help/say thanks?

• Subscribe to QUAKE LIVE if you're able. The hook.js script gets loaded thanks to those guys.
• Good pull requests are welcome. There is a lot to be done and rewritten.
• Report a bug, but check if it has already been reported.
• Help others work through the many issues that are bound to occur using QLHM.
• Join the QLHM IRC channel: #qlhm @ irc.quakenet.org (webchat)

How to use

1. Follow the client installation instructions below
2. Open the QUAKE LIVE standalone client
3. Click on the QLHM "HOOK" menu (to the lower-left of the QUAKE LIVE logo)
4. Under the "New" section enter the userscripts.org script ID (the number in the URL) or a comma-delimited list of script IDs and click "Apply".

• Alternatively, check the desired boxes in the provided userscript list and click "Apply".

TIP: To install QLRanks.com Display (111519), Quake Live Stream Notifier (114449), and Quake Live New Alt Browser (73076) in one go simply enter "111519,114449,73076" and click "Save".

NOTE: The server-side app is running on wn's server. If you'd prefer to run your own, feel free to modify config.BASE_URL in "hook.js".

Installation

Client

1. Locate your Quake Live config directory.
2. In your browser, navigate to the Version History wiki page.
3. Click the "Download hook.js" link for the latest release listed.
4. Save the displayed hook.js in your Quake Live config directory.

• NOTE: Be certain "Save as type" is set to "All Files" (or similar) in the download prompt.

Server

1. Install node.js
2. git clone https://github.com/supahgreg/qlhm.git or grab a specific release
3. cd server
4. npm install -d
5. node app
6. Update your client hook.js (config.BASE_URL)

Userscript Developers

You'll either need to add a full URL to your work-in-progress script to the config.manual array (within "hook.js") or come up with a creative alternative.

If you'd like, list your QUAKE LIVE script on the wiki.

Changelog / Version History

Refer to the Version History wiki page.