Psygraph Help

The following help is also available within the App itself.

Welcome to Psygraph

Psygraph keeps track of your meditation, breathing, and mindfulness through the use of various tools, such as a timer, counter, periodic gong, and note-taker. Each tool records events in response to button presses or device sensor changes, and those events are stored on your phone. You can optionally upload that information to any server with the Psygraph WordPress plugin to further analyze or visualize that event data.

Each tool is contained on a single page, and pages are arranged from left to right. The main page is the Home page, which displays the device status. There are four tools that create events: Stopwatch, Timer, Counter, and Note. The remaining three tools (List,Chart, and Graph) help to visualize that event data in different ways.

All events (such as stopwatch start and stop times) are assigned to a category. Four categories are present by default (Uncategorized, Meditate, Exercise, and Think), but other categories can be added in the application Preferences.

splashscreen about

Main Menu

The menu bar at the top of the app displays the current tool name and links that open the Tool and Action menus. Just below that is a bar that allows you to change the current tool (by clicking left or right) and a button that displays and changes the active category.

The Tool menu (in the upper left-hand corner) opens a page-specific menu with the following choices:

  • Tool settings: Open the settings for the current tool.
  • Tool help: Open the help for the current tool.
  • Change tool: Change the current tool.

The Action menu (in the upper right-hand corner) displays the following choices:

  • About: Open the About dialog, which describes the application.
  • Prefs: Open the application Preferences page to specify global options.
  • Login/Logout: Login or logout of the WordPress server.
  • Storage: Manage the storage for the events and settings.
  • Help: Open the Help page.



The Home page displays a summary of your data. It also display information about the server connection if you are logged in to a server. If you use Psygraph without connecting to a server, all data remains on your phone.

The Home settings display your username and the WordPress server URL, which you can edit if you are not logged in.

home home_settings


The Stopwatch tool times your meditation sessions or other activities. The reset button (on the left) and start/stop button (on the right) and allow you to reset, start and stop the stopwatch.

The Stopwatch settings let you add a GPS location and phone accelerometer data to the event. The GPS location is determined when the stopwatch stops, and the acceleration data is collected at the rate specified in the “Update interval” widget.



The Timer tool is a countdown alarm: the top widget displays the amount of time left and the bottom widget displays the total amount of time. The start/stop and reset buttons allow you to control the timer status. When the timer has elapsed (i.e. when the top field reaches zero), an alarm goes off that displays a text message and/or sound. The timer can be configured to loop (repeat) at periodic or random intervals.

The Timer settings configure the timer in different ways. The timer alarm governs what happens when the timer elapses: a text message, a sound, neither, or both. The alarm sound and text message are specific to each category, and are changed on the category section at the bottom of the settings. If the loop checkbox is selected, the timer restarts when it has finished (as long as the application is running). The reset interval and random interval fields specify the length of time the timer runs, which is the reset interval plus a random amount of time which does not exceed the random interval.



The Counter tool allows you to count your breath (or anything else you want to count). The black button increments the count, and the white button resets that count. The count can also be incremented by shaking the device or by clicking anywhere on the screen (see the tool settings and application preferences). You might practice counting your breath up to a certain value (such as 10), and then pressing the reset button. Your ability to keep track of this count can serve as a measure of mindfulness.

The Counter settings enable you to set a motion alarm (which increments the count), and to set a count target. The motion alarm has a threshold and a specific behavior if that threshold is exceeded, which is specified with the ‘Motion alarm’ list selection widget. The ‘Count target’ and ‘show count’ widgets are used for breath counting. For example, if the count target is set to 3, then pressing the increment button twice and the reset button once will result in a correct trial; pressing the reset button at any other value of the count will result in an incorrect trial.

counter counter_settings


The Note tool allows you create text notes and voice memos. Two text fields are displayed, one for the note title and one for the text of the note. The right button is used for recording audio data: the button turns red while recording, and the intensity of the color indicates the power of the recorded signal. Recording is stopped by pressing the button a second time. Notes are saved by pressing the left button: the audio data is stored as MP4 files which can be uploaded to the WordPress server as media files.

The Note settings allow you to attach location data to the note. They also allow you to turn off the confirmation dialog that indicates note submission.

note note_settings


The Map tool is in BETA status, and is only available if debugging is turned on. Pressing the round button allows you to start or stop gathering continuous location (GPS) data. Pressing the pin icon centers the map at the current location. Map markers can be created by clicking on the current location icon (a Sierpinsky triangle), or double-clicking anywhere on the map.

The Map settings allow you select the data provider used for the map imagery (either Open Street Map or ArcGIS, and MapBox if you have debugging turned on). You can also select to display all markers or all paths for the current category, as opposed to just the selected markers and paths. Selected events are always displayed, and are selected using the List tool. You can also select power saving mode, which governs location updates in the background, and set the desired accuracy.

map map_settings


The List tool shows a list of events in the current category. You can select all events for a given tool with the Select Events… button or by clicking on individual events. Several operations can be performed on the selected events, such as deleting them, removing them from the local event cache, or changing their category.

The List settings allow you to choose which tool’s data should be displayed. It also allows you to specify which columns of data should be displayed. By default, only notes (events from the note tool) are displayed.

list list_settings


The Chart tool displays the events in each category over time. By default, only events with a duration are shown (stopwatch and timer intervals), so that you can get a graphical indication of the amount of time you have spent on a given activity.

The Chart settings set the default range of the timeline: you can display the past hour, day, week, month or year of events. You can also specify to show all events, as opposed to only events with a duration.

chart chart_settings


The Graph tool displays several signals as a function of time. By default, the graph tool shows the ratio of correct to incorrect responses from the count tool, aggregated into daily bars. Therefore, it displays a measure of your mindfulness.

The Graph settings allow you to specify the display of other signals, as well as to specify the aggregation interval. Other signals which can be plotted include data from the phone’s accelerometer, time spent as measured by the stopwatch and timer, or simply a plot of the counter data.

graph graph_settings