Digital Sentry

From Support Wiki

For a complete product description, download links, and feature outline, visit the product page. This page is for product support only.

Contents 1 Introduction 2 Hiding/Showing the Digital Sentry Menu Icon 3 Customize Screenshot/Camshot Filenames 4 Keystroke Logging 5 Logging Variables 6 Known Issues 7 Feature Requests

Introduction

Digital Sentry allows you to monitor the system for specific events, and when they occur perform various tasks. Being the first time you've run Digital Sentry, let's go through a few of the basics:

• Digital Sentry appears as an icon on the right side of the menubar when it is running, and does not have a Dock icon. All major program functions can be accessed via this menu.
• We highly recommend setting a password on Digital Sentry so it cannot be closed or modified without proper authorization. Additionally, you may want to enable Digital Sentry at login. This can be done in the Preferences window.
• Begin by choosing Monitors from the Digital Sentry menu, and then pressing "New Monitor" on the toolbar. The assistant will guide you through the creation and setup of a monitor.
• For additional help, please choose the Help option from the Digital Sentry menu for complete documentation. For topics not covered, please contact our customer support team via our web site.

Some types of computer surveillance may not be permitted by law in your area. Do not use Digital Sentry if prohibited in your jurisdiction. We disclaim any and all liability for your actions.

Hiding/Showing the Digital Sentry Menu Icon

• Open Script Editor.app
• Type in:

 tell application "Digital Sentry"
   ShowMenu
 end tell

• Click Run.

To hide the menu simply change it to HideMenu instead of ShowMenu.

Customize Screenshot/Camshot Filenames

In the setup window for the screenshot and webcam shot actions, it is possible to include variables in the file name field to represent the current date and time. These variables also work for dynamically configuring e-mail message subjects and message bodies, as well as text messages.

• [YYYY] will become the four-digit current year.
• [MM] will become the two-digit current month (01-12).
• [M] will become the number of the current month (01-12), without any leading zero if otherwise required.
• [DD] will become the two-digit current day.
• [D] will become the number of the current day, without any leading zero if otherwise required.
• [HH] will become the current hour (with leading zero if needed) in 24-hour time format.
• [H] will become the current hour (without leading zero) in 24-hour time format.
• [XX] will become the current hour (with leading zero if needed) in 12-hour time format.
• [X] will become the current hour (without leading zero) in 12-hour time format.
• [AMPM] will become either AM or PM.
• [ii] will become the current minute of the hour (with leading zero if needed).
• [i] will become the current minute of the hour (without leading zero).
• [SS] will become the current second (with leading zero if needed).
• [S] will become the current second (without leading zero).
• An exmaple file name of: Screenshot_[YYYY]-[MM]-[DD]_[HH]-[MM]-[SS] would become: Screenshot_2009-12-25_08_30 if it was December 25, 2009 at 8:30am.

Keystroke Logging

Digital Sentry can record all keystrokes to a special log file. This file is stored in your Home/Library/Logs folder by default, but can be changed in the preferences window.

1. Open System Preferences from the Apple menu.
2. View the Universal Access preferences pane.
3. Check "Enable access for assistive devices".
4. Open the Digital Sentry Preferences window.
5. Enable keystroke logging.
6. Logging will commence immediately, and if the program is closed and reopened, it'll create a new log file and start recording again.

Some types of computer surveillance may not be permitted by law in your area. Do not use Digital Sentry if prohibited in your jurisdiction. We disclaim any and all liability for your actions.

Logging Variables

When logging a message via an action event, it is possible to include variables to make the message unique. They are:

• [Launched_AppName] will come the name of the last application launched that matched the conditions of this monitor (if it is an Application Launched monitor).
• [Launched_AppBundleID] will come the Bundle ID of the last application launched that matched the conditions of this monitor (if it is an Application Launched monitor).
• [Quit_AppName] will come the name of the last application closed that matched the conditions of this monitor (if it is an Application Quit monitor).
• [Quit_AppBundleID] will come the Bundle ID of the last application closed that matched the conditions of this monitor (if it is an Application Quit monitor).
• [Switched_AppName] will come the name of the last application brought foremost that matched the conditions of this monitor (if it is an Application Switched monitor).
• [Switched_AppBundleID] will come the Bundle ID of the last application brought foremost that matched the conditions of this monitor (if it is an Application Switched monitor).
• [YYYY] will become the four-digit current year.
• [MM] will become the two-digit current month (01-12).
• [M] will become the number of the current month (01-12), without any leading zero if otherwise required.
• [DD] will become the two-digit current day.
• [D] will become the number of the current day, without any leading zero if otherwise required.
• [HH] will become the current hour (with leading zero if needed) in 24-hour time format.
• [H] will become the current hour (without leading zero) in 24-hour time format.
• [XX] will become the current hour (with leading zero if needed) in 12-hour time format.
• [X] will become the current hour (without leading zero) in 12-hour time format.
• [AMPM] will become either AM or PM.
• [ii] will become the current minute of the hour (with leading zero if needed).
• [i] will become the current minute of the hour (without leading zero).
• [SS] will become the current second (with leading zero if needed).
• [S] will become the current second (without leading zero).
• An exmaple printout of: "My Time Logged: [YYYY]-[MM]-[DD]_[HH]-[MM]-[SS]" would become: "Time Logged: 2009-12-25_08_30" if it was December 25, 2009 at 8:30am.

Known Issues

1. Quit/Security Issue: Can close the app if a password is assigned by using ActivityMonitor.app, the command line, or any option that is not Force-Quit or the "Quit" menu item. This provides casual security from it being closed. Once we can detect when the app needs to be shutdown for an operating system process like Shutdown,
2. On some configurations, leaving the main window open and using Fast User Switching will cause the application to hang (we believe this is now fixed)
3. Monitors not shared across multiple user accounts.
4. Error messages with "incorrect login password" +" webcam". DSActionTakeWebCamPicture failed as InitVideo() malfunctioned; error code: -9405. DSActionTakeWebCamPicture failed as TakeWebCamPicture() did not execute properly.
5. Might be disabling the screensaver.

Feature Requests

1. Implement a sleep option when idle.
2. Put mail in queue bag if it failed to send, and keep retrying.
3. Add documentation for login errors explaining the order of events and how they are no in a queue.
4. Ability to delete active Actions by dragging them back out of the rightmost column.
5. Monitor for a specific key code and then emulate a different key press in response.
6. Ability to upload to an FTP server as an action.
7. Internal sleep function.
8. Stop function for audio playback.
9. Monitor e-mail and web pages for a certain bit of text, and when it appears, execute actions.
10. Multiple screenshots & webcam captures.
11. New screensaver/screen lock monitors.
12. Improve configuration for "Amount of time passes" event (seconds, minutes, hours, or days).
13. Option to prevent foreground app from receiving keystroke.
14. New Monitor - alert when web domain is accessed.
15. New Monitor - motion sensor for iSight
16. New Monitor - bluetooth device monitor
17. Run AppleScript event from file or lines of text