Difference between revisions of "Prey"
Kynikos.bot (talk | contribs) (Template:i18n is deprecated, use interlanguage links, see Help talk:I18n#"Dummy" interlanguage links and deprecation of Template:i18n) |
Lahwaacz.bot (talk | contribs) (update link(s) (avoid redirect)) |
||
| (18 intermediate revisions by 5 users not shown) | |||
| Line 10: | Line 10: | ||
== Configuration == | == Configuration == | ||
| + | Add your device using the control panel on Prey's website. | ||
| − | + | {{Note|The 'Add new device' button in the control panel links to Prey's download page for whatever reason. You can add a new device here: https://panel.preyproject.com/devices/new}} | |
| − | Run | + | Edit {{ic|/usr/share/prey/config}} and add your device key and API key, both of which are listed in Prey's control panel. |
| + | |||
| + | Run {{ic|/usr/share/prey/prey.sh}} as root to ensure that the configuration is correct. | ||
| + | |||
| + | {{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/}}.}} | ||
| + | |||
| + | Enable [[systemd]] service '''prey-tracker''' to automatically start Prey at boot {{ic|# systemctl enable prey-tracker.timer}} | ||
=== Modules === | === Modules === | ||
| − | To enable/disable modules, you | + | 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 === | === GUI config === | ||
| − | You can | + | You can use a GUI to configure prey using the {{ic|prey-config}} script: |
| − | + | # /usr/share/prey/platform/linux/prey-config.py | |
| − | Note that if this doesn't work you are missing a dependency, not sure if | + | Note that if this doesn't work you are missing a dependency, not sure if Python alone suffices. |
=== Standalone Mode === | === Standalone Mode === | ||
| − | + | The GUI can be used to configure standalone mode. | |
| − | Alternatively | + | 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/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/modules/alarm/core/run}} | ||
| − | + | === Troubleshooting === | |
| + | To troubleshoot, run | ||
| − | + | {{bc|# /usr/share/prey/prey.sh --check}} | |
| − | + | Ensure you have enabled [[systemd]] service '''prey-tracker.service''' and '''prey-tracker.timer''' to start Prey at boot. | |
| − | + | If you're not receiving webcam images in you reports, install {{Pkg|xawtv}} from the official repositories. | |
| − | |||
| − | |||
==== 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 | + | to the beginning of {{ic|/usr/share/prey/modules/session/core/run}}. |
| − | |||
| − | to the | ||
=== 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:29, 28 March 2014
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.
Contents
Installation
Install prey-trackerAUR from the AUR.
Configuration
Add your device using the control panel on Prey's website.
Edit /usr/share/prey/config and add your device key and API key, both of which are listed in Prey's control panel.
Run /usr/share/prey/prey.sh as root to ensure that the configuration is correct.
Enable systemd service prey-tracker to automatically start Prey at boot # systemctl enable prey-tracker.timer
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:
# /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
Ensure you have enabled systemd service prey-tracker.service and prey-tracker.timer to start Prey at boot.
If you're not receiving webcam images in you reports, install xawtv from the official repositories.
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.