Frequently Asked Questions (for iOS)

Ad in
        YourTango.com




Introduction:

This FAQ was written to support “Quit Snoring” (QS), v 6.1 for the iPhone, the iPod Touch and the iPad and is available in the Apple App Store.
An Android version is already selling in "Google Play" but it lacks some of the features that the iOS version has.


Q1: Do I need to connect the device to its charger while it monitors my sleep?

A: It is preferred however not mandatory. A fully charged iPhone 3GS will drain about 20% to 30% of its battery over a period of 8 hours while using QS. If you choose to record the entire sleep session, QS will drain more but again, a fully charged battery should suffice. Using an iPhone 4 will give you better millage and with an iPad it is not an issue at all.
The answer assumes that your device "goes to sleep" automatically and turns off the screen.



Q2: What can be done to prevent cellular phone radiation from affecting me when I sleep close to the iPhone?

A: When using QS, you may prevent cellular phone radiation by switching the iPhone to "Airplane Mode" before going to sleep (first option in the iPhone's "Settings") Don't forget that in this mode, the iPhone will not function as a phone and that you need to turn the "Airplane Mode" off after you wake up.



Q3: How does QS nudge me when I snore?

A: QS nudges you either by playing a pre-recorded clip of your choice, or by vibrating the iPhone, or by doing both. You may control the way QS nudges via the QS Setting screen. Note that vibration is not available on iPad or on iPod Touch.



Q4: Can I modify the clip played by QS for nudging me when snoring is detected?

A: Yes. This can be done via the QS Setting screen. You may use one or few of the factory supplied clips, or record your own clips. You may combine any number of sound clips into a "playlist" and in each "nudge" a different clip shall be played. Note that you may also control the volume (independently of the volume set on the device itself) and that also different nudges are recorded in different volumes.
In fact, we recommend using multiple nudges, because studies show that such a scheme has a better chance of influencing you while you sleep.



Q5: Is there a way for QS to nudge me without waking my partner?

A: Probably yes. This may be achieved by setting QS (via the QS Setting screen) to nudge you by vibrating the iPhone without playing the pre-recorded clip. Another way is to decrease the clip's volume (via the QS Setting screen). However, this depends on how sensitive your partner is.



Q6: Can I adjust QS to ignore background noise?

A: Yes. If you have set QS to use "Dynamic Threshold" you do not need to worry about that. If you prefer to set the threshold manually, you can achieve this by modifying the Sensitivity parameter in the QS setting screen assuming the background noise does not change much during the night.
Also note that if the background noise is louder than your breathing/snoring noise, then of course, this app would not be effective at all.



Q7: Where exactly should I place the iPhone for monitoring my sleep?

A: Generally you should place it somewhere near your head. It should be close enough to detect your snoring and close enough to effectively nudge you without disrupting your partner's sleep. You may find the optimal distance for your convenience by asking your partner to do some experiments with QS while you sleep. For example, your partner may move the iPhone while you sleep, and experiment its sensitivity to your personal snoring by observing the noise indicator on QS's main monitoring screen. Your partner may also adjust the volume of the nudge clip to best fit the location you chose for placing the iPhone. If you prefer to use the vibration feature, you may want to attach the iPhone to your body (perhaps with an armband) or under your pillow. That is, if you are not worried about damaging the iPhone if you roll and toss around during your sleep.
Note: The position of the microphone on the device you are using is also important. You normally want the microphone to be pointed to the general direction of your head... On the iPhone, the microphone is at the bottom near the "home" button. On the iPad the microphone is on the upper side far away from the "home" button. As for the iPod Touch: for the older generation iPod Touch devices, you need to attach an external microphone in order for QS to work.



Q8: How do I make sure that the “nudging” feature of QS really works?

A: You may simulate the nudge in the following way; Press the "Start" or "Continue" button of QS and watch the needle on the noise indicator; Make a sound that will keep the needle well in the red area of the dial for about 2 seconds, then be quiet for about 3 seconds. Repeat this for 4-5 times until you hear the "nudge" clip and/or the vibration. You should also be able to see how the "nudge" algorithm advances by seeing the red progress bar advancing inside the gauge.



Q9: May I use QS for monitoring only (without nudging me when I snore)?

A: Yes of course. If you turn off nudging altogether (via the QS setting screen), QS will not attempt to nudge you if you snore. It will only listen to you and keep track of the sound during the whole night. You will be able to view a graph of the sound and maybe listen to portions of it after you wake up and perhaps learn more about your sleep pattern and how noisy you are.



Q10: Can QS help people who suffer from sleep apnea?

A: The current version of QS cannot directly identify sleep apnea or other sleep disorders. However if you examine the graph carefully, you may be able to identify suspicious incidents of sleep apnea and other problems. If you also record your sleep and listen to these suspicious areas, you may find better clues to the problem. An example for a suspicious sleep apnea incident may be an area of the graph (zoom to max) where you clearly see few rhythmic spikes of noise followed by a relatively long silent period, followed by an even higher single spike. If you are not sure, take this to your doctor and show it to him/her.



Q11: How can I check how noisy I am during my sleep?

A: After waking up you may examine the sleep session by going to the History screen and selecting your session. The Summary screen displays few statistics. In particular, watch the "Average Noise". You may also examine the graph of noises you made during your sleep. If you want to compare noises you made in different nights, it is advisable that you place the iPhone in the same relative position every night so that the measured noise is not affected from different distances to your mouth, etc.



Q12: How can I know if QS actually helped me stopped snoring?

A: After waking up, you may examine the graph on the QS screen, and look for indications for nudges done by QS for stopping your snoring. You may also examine the graph in more detail by zooming into certain sections in the graph.



Q13: What happens if I get a phone call or an SMS while I sleep and while QS is working?

A: It depends if the user answers the phone or ignores it. If the user ignores the phone, QS will continue. The history graph will reflect the phone call as an external event. If the user answers the phone, QS will restart when the phone conversation ends and the user will have to press "Start" again.



Q14: May I sleep with QS and use the iPhone build-in Alarm Clock?

A: Yes of course. The Alarm will sound and will also be reflected in the historical graph as an external event.



Q15: May I sleep with QS and use another app with radio and alarm clock?

A: NO. The reason is, that QS needs to run in the foreground in order to listen to you through the microphone.



Q16: What happens if I wake up in the morning and forget to stop QS?

A: It will stop recording data and sound by itself after 12 hours of use.



Q17: How much space does QS uses in memory and on storage?

A: (1) Runtime Memory: QS takes very little memory when it runs. However, when displaying session history and graph of a long sleep session it may take quite a lot of memory and if other large apps are running in the backgr/ound, they may cause some unexpected behavior to QS.
A: (2) Storage Space: QS itself consumes very little storage space on the device. However, the recordings of long sleep sessions may accumulate and consume a lot of storage. Each long sleep session takes few megabytes of data + about 80 megabytes of recorded sound. If you do not clean your sleep session history, the storage will accumulate and may fill up all available space on your device.



Q18: What happens if I quit or kill the app while it is working? Would I lose any session data?

A: If you quit QS (by pressing the "Home" physical button), QS will stop monitoring the noise and the sleep session will be terminated. The session data is not lost since QS updates the data files before it really exits. However, if the application exists abnormally, some data (from the end of the sleep session) may be lost because it had not been saved in time to the permanent storage.



Q19: What happens if I wake up in the middle of the night and need to use my deviceC?

A: You may quit QS and use the device for whatever. If you restart QS in about 10 minutes, QS will ask you if you want to continue the previous session or start a new session.



Q20: How do I transfer my session data from my device into a PC?

A: You may either email the session data (without recorded sound), or transfer the entire session data to the application "QS MASTER". Beacuse the recorded sound files are large, they cannot be emailed. However, even without the recorded sound you still get all the relevant information and view it a graph. Emailing is done from within the graph screen. Transfering the session to "QS Master" is done from the summary screen. It requires that you first install "QS MASTER" on a PC (Windows or Mac) that is on the same WiFi network.



Q21: What is the sound quality and file format of the recorded sleep session?

A: (1) In "LOW" (the default recording level): sound is recorded on one track at 8000 Hz. It is done with a narrow band speech codec which is very economic in storage. Note that the file format is called "AMR" and is stored as a ".caf" file.
A: (2) In "MEDIUM": sound is recorded on one track at 16000 Hz. It takes about 5 times more space than the "LOW" and from our experience, the quality is just a little better. Note that the file format is called "Apple Losless" and is stored as a ".m4a" file.
The recorded files are not saved in a popular file format such as MP3 because it takes way too much space. The above file formats were chosen because they consume the least amount of space and the recording quality of snoring is not really important...



Q22: I am using a CPAP machine. May I use QS to alert me if the mask falls from my face?

A: It depends. If this is a modern CPAP that does not make a lot of noise, and you are likely to start snoring when the mask falls, then yes - it will probably work just fine and you'd better set a very loud alarm for this case because you need to fully wake up and re-arrange the mask.



Q23: Does QS continue to work when in the background?

A: No, it is designed to work in the foreground only. if you bring another application to the front, QS will stop working and will automatically be moved to the background. If you then bring it to the foreground, it will start a new sleep session. However, if you do this in less than 10 minutes, it will allow you to continue the previous session.



Q24: Can I process the data created by QS by myself or in a different application?

A: Well, the data generated by QS was not designed to be processed by any other app except SU Master. However, with some effort you may be able to do that. The best way is to first transfer the sessions into SU Master which is the PC/Mac application. More about SU Master and the file formats in the questions below.



Q25: What is the format of the files sent by the email from QS?

A: QS sends out 4 files:
  1. graph.png - This is a simple snapshot of the graph (as you see it just before the mail is sent).
  2. threshold.txt - This file contains two columns of numbers. The first is a timestamp and the second is the noise level. The timestamp is expressed in seconds since 1/1/2001 in GMT (and the precision is in microseconds). In order to get your local time, you need to add the TimeZone value which is found in the event.txt file.
  3. event.txt - This file contains the list of events that occured during the session plus some various attributes of the phone and the app. This file is in plain text and easy to understand.
  4. settings.txt - This file contains all the settings of the app (corresponding to the values of in the "Settings" and "Advanced Settings" screens of the app. If you change your settings in the middle of the session, the changes will be recorded with a timestamp too. This is also a plain text file that is easy to understand.



Q26: What is the format of the files transferred by QS to SU Master?

A: There are two groups of files that are transferred:
  1. Data files. These are the same files that are also sent by email (described in Q25 above).
  2. Sound files. The recorded session files are described in Q21 above. Each session may be divided into multiple segments. Also, short "nudge" files are transferred. These may be ".mp3" or ".wav" files.



Q27: Where do I find the session files used by SU Master?

A: First, you need to know that The default folder location for SU Master is:
On Mac: /Users/<YourUserName>Library/Application Support/SUMaster
On Windows: <YourDrive>:\Documents and Settings\<YourUserName>\Application Data\SUMaster
Or: <YourDrive>:\Users\<YourUserName>\AppData\Roaming\SUMaster

Under the above folder, you'll find a sub-folder called "Sessions". Each session is stored in a sub-folder that is named as a timestamp (of when your sleep session started). You may use the Excel formula in Q26 below to translate timestamps into human-readable form.



Q28: I want to process the data myself in a program such as Excel, how do I do this?

A: You may do this using the following Excel formula: =((((timestampcell+timezonevalue)/60)/60)/24)+DATE(2001;1;1)
Replace "timestampcell" with the reference to the cell where the timestamp is. Replace "timezonevalue" with the number copied from the "threshold.txt" file (this is your timezone distance from GMT in seconds).
Here's a sample Excel file that includes such a formula: TimestampFormula.xls. In this example, the timezone value is in a cell and is set to 7200 (+2 hours from Greenwich).



Q29: What is the meaning of the noise level numbers and how do I convert them to decibels (dB)?

A: The noise levels are represented in numbers between 0 and 100. It is meant to simplify reading for people who may not understand what decibels mean. These adjusted linear numbers (L) may be converted to decibels (dB) using the following simple formula:
   6L + 40 = dB
Please note the following: