Digital Sentry Manual

Our manual is always expanding! While we strongly believe our products as so intuitive you shouldn't need a manual, there are exceptions now and then. If you feel there is something missing from the documentation, please contact us.

Print Page

Table of Contents

  1. General
    1. Customize Screenshot/Camshot Filenames
    2. Feature Requests
    3. Hide/Show Menubar Icon
    4. Introduction
    5. Keystroke Logging
    6. Logging Variables
  2. Troubleshooting
    1. Known Issues

General

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 example 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.

Feature Requests
  1. Battery percentage monitor
  2. Battery charging/not charging monitor
  3. Parse variables not just for path names but for shell text as well, ie: echo [YYYY]-[MM]-[DD]_[HH]-[MM]-[SS],[Switched_AppName],[Switched_AppBundleID] >> ~/.AppLog.log
  4. Success and failure reports for using the "Advanced Clean" features.
  5. Make Overview, Purge Locations, About, Trash, etc. all a uniform size, and make the dymamic categories default to that size as well.
  6. Add grey bar to panes which have buttons that affect the entire panel.
  7. "Monitor for a window going away. For example, sometimes I'm copying a HUGE file and I want to know when it's done. This is easy to track by knowing when the transfer window disappears. It would be best if you could quickly pick the window like a screenshot tool."
  8. "Monitor a pixel (or group of pixels) for a change. This would actually be a crude way of doing #1, since I could simply monitor the unchanging portion of a window, then when the window disappears, presumably the background would be a different color and I would get an alert."
  9. Implement a sleep option when idle.
  10. Put mail in queue bag if it failed to send, and keep retrying.
  11. Add documentation for login errors explaining the order of events and how they are not in a queue.
  12. Ability to delete active Actions by dragging them back out of the rightmost column.
  13. Monitor for a specific key code and then emulate a different key press in response.
  14. Ability to upload to an FTP server as an action.
  15. Internal sleep function.
  16. Stop function for audio playback.
  17. Monitor e-mail and web pages for a certain bit of text, and when it appears, execute actions.
  18. Multiple screenshots & webcam captures.
  19. New screensaver/screen lock monitors.
  20. Improve configuration for "Amount of time passes" event (seconds, minutes, hours, or days).
  21. Option to prevent foreground app from receiving keystroke.
  22. New Monitor - alert when web domain is accessed.
  23. New Monitor - motion sensor for iSight.
  24. New Monitor - Bluetooth device monitor.
  25. Run AppleScript event from file or lines of text.

Hide/Show Menubar 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.


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 website.

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.


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.

On Mac OS X 10.6 through 10.8
  • Open System Preferences from the Apple menu.
  • View the Universal Access (labeled "Accessibility" on newer operating systems) preferences pane.
  • Check "Enable access for assistive devices".
  • Open the Digital Sentry Preferences window and click on the "Logging" tab.
  • Enable keystroke logging.
  • Logging will commence immediately, and if the program is closed and reopened, it'll create a new log file and start recording again.
On Mac OS X 10.9 and later
  • Open System Preferences from the Apple menu.
  • Click the "Security & Privacy" icon.
  • Unlock this preferences pane to make changes by pressing the lock icon at the bottom left.
  • Click the "Privacy" tab.
  • Click the "Accessibility" section.
  • Place a checkmark next to "Digital Sentry"

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 become the name of the last application launched that matched the conditions of this monitor (if it is an Application Launched monitor).
  • [Launched_AppBundleID] will become 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 become the name of the last application closed that matched the conditions of this monitor (if it is an Application Quit monitor).
  • [Quit_AppBundleID] will become 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 become 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 become 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.

Troubleshooting

Known Issues
  1. Power source changed monitor does not seem to work on 10.10 and 10.11
  2. ShowMenu applescript not working on Mavericks (move to new sdef format)
  3. 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.
  4. 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).
  5. Monitors not shared across multiple user accounts.
  6. Error messages with "incorrect login password" +" webcam". DSActionTakeWebCamPicture failed as InitVideo() malfunctioned; error code: -9405. DSActionTakeWebCamPicture failed as TakeWebCamPicture() did not execute properly.
  7. Might be disabling the screensaver.
  8. Does not bring app foremost on wake & does not hide menubar for Fake Security Alert/Self-Destruct