• Home
• Download
• Documentation
• Tips

How to Install?

• Download the code
• Extract the folder
• goto ps3tokey folder

• Run the commands:

• make
• sudo make install
• READ THE HOW TO USE? SECTION

How to use?

• Run the commands:

• ps3tokey

Note:

You need to have the PS3 control connected with the USB/Bluetooth

If you need help with the bluetooth read the next SECTION

1. If the ps3tokey is running and nothing happen. Please push the PS Button before

2. If you have more than one control connected, the ps2tokey ask what to use

Command Variable

Variable	Description	Example
Default	Set the input dev file to use	ps3tokey /dev/input/event11 Note: Most of the cases this is NOT neccesary
p	Load the profile map for emulate the key	ps3tokey -p mame (The file /usr/share/ps3tokey/mame.ps3profile or $HOME/.ps3tokey/mame.ps3profile must exits)
h	Show the help	ps3tokey -h
v	Show the version	ps3tokey -v

Profiles

The profile path are in /usr/share/ps3tokey/ and $HOME/.ps3tokey/

Note: Right now i am working in the GUI for edit/add the profiles

The last line in the Profile MUST TO BE A EMPTY LINE

Key	Description	Example
Triangle	Handle the Triangle event for keypress and release	Triangle Key s
Square	Handle the Square event for keypress and release	Square Key a
Circle	Handle the Circle event for keypress and release	Circle Key x
Cross	Handle the Cross event for keypress and release	Cross Key z
Up	Handle the Up event for keypress and release	Up Key Up
Down	Handle the Down event for keypress and release	Down Key Down
Left	Handle the Left event for keypress and release	Left Key Left
Right	Handle the Right event for keypress and release	Right Key Right
L1	Handle the L1 event for keypress and release	L1 Key d
L2	Handle the L2 event for keypress and release	L2 Key f
L3	Handle the L3 event for keypress and release	L3 Key F2
R1	Handle the R1 event for keypress and release	R1 Key c
R2	Handle the R2 event for keypress and release	R2 Key v
R3	Handle the R3 event for keypress and release	R3 Key F4
Select	Handle the Select event for keypress and release	Select Key shift
Start	Handle the Start event for keypress and release	Start Key Return
Right	Handle the Right event for keypress and release	PS Key space
Left_Analog_Up	Handle the left analog event for the up keypress and release	Left_Analog_Up Key Up
Left_Analog_Down	Handle the left analog event for the down keypress and release	Left_Analog_Down Key Down
Left_Analog_Left	Handle the left analog event for the left keypress and release	Left_Analog_Left Key Left
Left_Analog_Right	Handle the left analog event for the right keypress and release	Left_Analog_Right Key Right
Right_Analog_Up	Handle the right analog event for the up keypress and release	Right_Analog_Up Key Up
Right_Analog_Down	Handle the right analog event for the down keypress and release	Right_Analog_Down Key Down
Right_Analog_Left	Handle the right analog event for the left keypress and release	Right_Analog_Left Key Left
Right_Analog_Right	Handle the right analog event for the right keypress and release	Right_Analog_Right Key Right

Visual Aid: this is the default profile

Keep in mind the last line is empty

The above keys works for the Press/Release as a single event
But you can handle in two differente event with add the suffix

Suffix	Description	Example
_Press	Handle just the press event	Cross_Press echo 'Just the press' Left_Press echo 'Just the press'
_Release	Handle just the release event	Cross_Release echo 'Just the release' Left_Release echo 'Just the release'

How to handle the Bluetooth?

Ok, The magic of the bluetooth is not complicated, but sometime is hard because the bluetoothd try to use the PS3 control as a normalt bluetooth device.

I recommend you to install the sixad application. Check this

Install and use

• sudo apt-add-repository ppa:falk-t-j/qtsixa
• sudo apt-get update
• sudo apt-get install sixad
• Plug the Ps3 Control with USB cable
• sudo sixpair
• Unplug the Ps3 Control
• sixad --start
• Press the PS button and wait to be detected
• Open a new terminal
• ps3tokey