Difference between revisions of "Prey"

From ArchWiki
Jump to: navigation, search
m (Standalone Mode: Added code formatting)
m (Configuration: Added code formatting)
(One intermediate revision by the same user not shown)
Line 10: Line 10:
  
 
== Configuration ==
 
== Configuration ==
 
+
Edit {{ic|/usr/share/prey-tracker/config}} and add your device key and API key in the appropriate place. Run {{ic|/usr/share/prey-tracker/prey.sh}} as root to ensure that the configuration is correct.
Edit "/usr/share/prey-tracker/config" and add your device key and API key in the appropriate place.
+
 
+
Run "sudo /usr/share/prey-tracker/prey.sh" and check the results.
+
 
+
 
=== Modules ===
 
=== Modules ===
 
To enable/disable modules, you must change the executable permissions for the the "run" files in prey's respective modules/core subdirectories. Adding executable permissions to a module will enable it, while removing permissions will disable the module.
 
To enable/disable modules, you must change the executable permissions for the the "run" files in prey's respective modules/core subdirectories. Adding executable permissions to a module will enable it, while removing permissions will disable the module.
Line 36: Line 32:
  
 
=== Troubleshooting ===
 
=== Troubleshooting ===
 +
To troubleshoot, run
  
To troubleshoot, try:
+
{{bc|# /usr/share/prey-tracker/prey.sh --check}}
 
+
sudo /usr/share/prey-tracker/prey.sh --check
+
  
 
==== Beeping ====
 
==== Beeping ====
 
+
If [[Taking_a_Screenshot#scrot|scrot]] is installed, prey will use it to take a screenshot if the {{ic|session}} module is enabled. Unfortunately, scrot emits an annoying beep everytime it is run. To disable beeping, append {{ic|xset -b}}
If you have scrot installed, prey will use it to take a screenshot if the "session" module is enabled. Unfortunately, scrot emits an annoying beep everytime it is run. To avoid beeping, you have to add
+
to the beginning of {{ic|/usr/share/prey-tracker/modules/session/core/run}}.
xset -b
+
to the file /usr/share/prey-tracker/modules/session/core/run at the top
+
  
 
=== Bugs ===
 
=== Bugs ===
 
There seems to be a bug in version 0.5.3 which gives an error if the SMTP password is set when using "email" post_method, which returns an error, but works fine when executed normally without the --check option.
 
There seems to be a bug in version 0.5.3 which gives an error if the SMTP password is set when using "email" post_method, which returns an error, but works fine when executed normally without the --check option.

Revision as of 21:26, 12 September 2012

Prey is a set of bash scripts that helps you track your computer when it is stolen.

This guide shows you how to install Prey.

Installation

Install prey-trackerAUR from the AUR.

Configuration

Edit /usr/share/prey-tracker/config and add your device key and API key in the appropriate place. Run /usr/share/prey-tracker/prey.sh as root to ensure that the configuration is correct.

Modules

To enable/disable modules, you must change the executable permissions for the the "run" files in prey's respective modules/core subdirectories. Adding executable permissions to a module will enable it, while removing permissions will disable the module.

GUI config

You can use a GUI to configure prey using the prey-config script:

# sudo /usr/share/prey-tracker/platform/linux/prey-config.py

Note that if this doesn't work you are missing a dependency, not sure if python alone suffices.

Standalone Mode

The GUI can be used to configure standalone mode.

Alternatively,/usr/share/prey-tracker/config can be edited to change post_method to email and edit the SMTP settings.

Note that in Standalone Mode, all modules in /usr/share/prey-tracker/modules run by default. To disable them, remove executable permissions on the module's run file (located within the module's core subdirectory). For example, the following command disables the alarm module:

# chmod -x /usr/share/prey-tracker/modules/alarm/core/run

Troubleshooting

To troubleshoot, run

# /usr/share/prey-tracker/prey.sh --check

Beeping

If scrot is installed, prey will use it to take a screenshot if the session module is enabled. Unfortunately, scrot emits an annoying beep everytime it is run. To disable beeping, append xset -b to the beginning of /usr/share/prey-tracker/modules/session/core/run.

Bugs

There seems to be a bug in version 0.5.3 which gives an error if the SMTP password is set when using "email" post_method, which returns an error, but works fine when executed normally without the --check option.