banner

home news faq download


QuickPlay Remapper - README and FAQ
----------------------------------------------

Version 1.3.1
9 September 2009 (Revised 23 June 2010)
Website: http://quickplay.hostzi.com
Author: Th3_uN1Qu3

I. What is this software?
--------------------------

This software allows the remapping of the QuickPlay buttons on your HP notebook to the programs of your choice, without needing any of HP's software installed.

Since v1.3 it also has the function of speeding up the volume controls (up to 6 times) if you feel they change level too slow. This function is called a "hack" because all it does is simply send Windows multiple volume keypress events on a single touch of the volume bar. Windows Vista and Windows 7's default setting for a single press of the volume key is to change level by 2%, in XP this used to be 5%. The default setting of this program sends 3 keypresses on every touch, thus changes volume in 6% increments. I have found 6% to be the best balance between speed and usability (you wouldn't want a volume control that flicks from mute to max instantly), but some may like it a bit faster, so i left the speed boost configurable.

II. Why use this software?
---------------------------

You may find this software useful for the following reasons

- You do not like QuickPlay and want the QP buttons to do something else
- You have uninstalled QuickPlay and found that the QP buttons are useless now
- Your laptop changes volume too slowly, requiring multiple swipes of the volume bar

III. How to use this software? What requirements does it have?
---------------------------------------------------------------

The requirement is a HP notebook with QuickPlay buttons, obviously. The stable version is confirmed working on DV5 series, DV9000 series, Compaq CQ40 series, nx9000 series. There are beta versions for the dv6500, dv6t, dv7 and zv6000 series. It should run on Windows XP/Vista/7. It has no extra software requirements.

Usage is extremely simple. Extract the archive to a folder of your choice. Open the QPRemapper program and select an application using the Browse button. This application will now be assigned to the specified QuickPlay key.
Check "Apply at startup" if you want your settings re-applied each time the computer starts. You can now close the program, the mapping will be handled automatically in the background.
If you wish to restore the default mapping, simply uncheck the corresponding box in QPRemapper.

Note: The QuickPlay key is labeled as the "Presentation" key on nx9000 series and older.

IV. But wasn't there a way to...
---------------------------------

There is another way to remap the QuickPlay button but it requires QuickPlay installed, which pretty much defeats its purpose. Also it involves editing the registry which can be potentially dangerous for beginners. Using my software does not involve editing the registry, nor does it edit the registry itself. Everything is controlled by a simple graphical user interface (GUI).

V. Will this software void my warranty/damage my computer/decrease battery life?
-------------------------------------------------------------------------------------

No. It is designed with minimal resource usage in mind, it will not alter system files and it will not write to the registry. It simply intercepts the QuickPlay keys and assigns them to a program of your choice. However keep in mind that it is distributed "as-is" and any damage that this program might cause will not be covered by the author nor by HP.

VI. How can I help you develop this software?
----------------------------------------------

You can help me by reporting any issues at the contact email address at the beginning of this document. You may contact me if the keys on your laptop aren't fully supported. In the email please report the output of this program, which detects the keycodes of your special keys so i can add them to the remapper program. You may also contact me if you have a feature request, but keep in mind that this software has a very specific purpose and all the features it needs are implemented already.

I might think of supporting other brands of laptops if i receive enough requests, or if you offer a little donation.

VII. How to remove this software
---------------------------------

Open QPRemapper and uncheck "Apply at startup". Restart your computer, then delete the files mentioned in "Software components" below. Alternatively, you can remove it without restarting the computer. Open the Windows Task Manager, go to the Processes tab, click on QPKeys.exe, click End Process, Yes. Then delete the files.

VIII. Software components
--------------------------

QPRemapper.exe - Main program and graphical interface (GUI). It allows remapping of the QuickPlay buttons, handles the buttons until it is closed, and saves the configuration.

QPKeys.exe - Button handler. Basically main program minus the GUI, with a number of speed optimizations (unlike the GUI which has to update Remap.ini every time a modification is made, QPKeys never accesses the hard drive after it is loaded). It is loaded when the GUI exits, or at computer startup if the "Apply at startup" option is checked in the GUI.

QPR.ico - Program icon. Used to make the startup entry prettier. :)

Remap.ini - Configuration file. All options are saved here by QPRemapper and read upon program reload. QPKeys also reads this file when it is loaded. If this file does not exist, it will be automatically created by QPRemapper.

IX. What language is this software written in? Can you give me the source code?
--------------------------------------------------------------------------------

This software is written in the AutoHotkey scripting language. I do not plan to give away the source code yet. If I will stop working on this program, I will release the source under the GNU GPL v3 license.

X. Licensing
-------------

This software is FREEWARE. You may use it freely on any number of computers and you may distribute free copies of it provided all files mentioned in "Software Components" (except the configuration file) are not altered or missing. You may not dissasemble, decompile, or otherwise reverse engineer the software. You may not sell the software. The source code is the intellectual property of the author (Th3_uN1Qu3). AutoHotkey is ©2003-2009 Chris Mallett, portions ©AutoIt Team. HP, MediaSmart, QuickPlay and the QuickPlay logo are ©Hewlett-Packard Company. I am in no way affiliated with Hewlett-Packard.