Digital Sentry

From Koingo Software 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 Customize Screenshot/Camshot Filenames 3 Keystroke Logging 4 Logging Variables 5 Known Issues 6 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.

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. Sparkle will allow the app to quit without authentication.
2. On some configurations, leaving the main window open and using Fast User Switching will cause the application to hang.
3. Sometimes will hang on user logout/computer shutdown. We cannot narrow this one down. We need steps to reproduce it.
4. Store AbsolutePath and RelativePath in folder item method so it can find the file still if it has been replaced with another file of the same name.

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.