Difference between revisions of "Prey"

From ArchWiki
Jump to: navigation, search
m (Troubleshooting: Added code formatting)
(Configuration)
(2 intermediate revisions by 2 users not shown)
Line 10: Line 10:
  
 
== Configuration ==
 
== Configuration ==
 +
Edit {{ic|/usr/share/prey/config}} and add your device key and API key in the appropriate place. Run {{ic|/usr/share/prey/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.
+
{{Note|The old version of {{AUR|prey-tracker}}  ( < 0.5.9-3) was in {{ic|/usr/share/prey-tracker/}} folder, now (>0.5.10-2) it is in {{ic|/usr/share/prey/}}.}}
 
+
Run "sudo /usr/share/prey-tracker/prey.sh" and check the results.
+
  
 
=== Modules ===
 
=== Modules ===
Line 22: Line 21:
 
You can use a GUI to configure prey using the {{ic|prey-config}} script:
 
You can use a GUI to configure prey using the {{ic|prey-config}} script:
  
{{bc|# sudo /usr/share/prey-tracker/platform/linux/prey-config.py}}
+
{{bc|# sudo /usr/share/prey/platform/linux/prey-config.py}}
  
 
Note that if this doesn't work you are missing a dependency, not sure if python alone suffices.
 
Note that if this doesn't work you are missing a dependency, not sure if python alone suffices.
Line 30: Line 29:
 
The GUI can be used to configure standalone mode.
 
The GUI can be used to configure standalone mode.
  
Alternatively,{{ic|/usr/share/prey-tracker/config}} can be edited to change {{ic|post_method}} to {{ic|email}} and edit the SMTP settings.
+
Alternatively,{{ic|/usr/share/prey/config}} can be edited to change {{ic|post_method}} to {{ic|email}} and edit the SMTP settings.
  
Note that in Standalone Mode, all modules in {{ic|/usr/share/prey-tracker/modules}} run by default. To disable them, remove executable permissions on the module's {{ic|run}} file (located within the module's {{ic|core}} subdirectory). For example, the following command disables the {{ic|alarm}} module:
+
Note that in Standalone Mode, all modules in {{ic|/usr/share/prey/modules}} run by default. To disable them, remove executable permissions on the module's {{ic|run}} file (located within the module's {{ic|core}} subdirectory). For example, the following command disables the {{ic|alarm}} module:
{{bc|# chmod -x /usr/share/prey-tracker/modules/alarm/core/run}}
+
{{bc|# chmod -x /usr/share/prey/modules/alarm/core/run}}
  
 
=== Troubleshooting ===
 
=== Troubleshooting ===
 
To troubleshoot, run
 
To troubleshoot, run
  
{{bc|# /usr/share/prey-tracker/prey.sh --check}}
+
{{bc|# /usr/share/prey/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 [[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}}
to the beginning of {{ic|/usr/share/prey-tracker/modules/session/core/run}}.
+
to the beginning of {{ic|/usr/share/prey/modules/session/core/run}}.
  
 
=== 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 22:32, 7 April 2013

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/config and add your device key and API key in the appropriate place. Run /usr/share/prey/prey.sh as root to ensure that the configuration is correct.

Note: The old version of prey-trackerAUR ( < 0.5.9-3) was in /usr/share/prey-tracker/ folder, now (>0.5.10-2) it is in /usr/share/prey/.

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/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/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/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/modules/alarm/core/run

Troubleshooting

To troubleshoot, run

# /usr/share/prey/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/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.