This file contains a collection of all the README and Help files for HotPaw Production's iPhone/iPad/iOS apps. -- The HotPaw inTuna Guitar Strobe Tuner is an iPhone application which uses the built-in microphone on your iPhone to allow you to tune your guitar via visual displays. It includes both a sharp/flat frequency indicator and a highly accurate and responsive strobe tuning window. A 6 position tuning indicator allows you to see at a glance which string pitch the tuner is currently analyzing. You can lock the indicator to a particular string in noisy environments, or let inTuna auto-select. Above the tuning indicator, an animated abstract waterfall waveform is displayed within a strobe window to allow extremely precise final tuning. With the waterfall strobe tuning window, even very slight differences in frequency between the pitch which the microphone detects and the target pitch will cause the abstract waveform to waver or move sideways as it cascades down the strobe window. Also included is a pitch frequency readout in Hz and cents. Configuration options include support for 6 popular guitar tunings, and a Concert A reference frequency adjustment. Touching the one of the note names on the display will play that reference pitch though your earphones, and lock the indicator to that string. Touching the lock icon will unlock string auto-select mode. ------ A Short Users Manual for the HotPaw inTuna guitar tuner Place your iPhone where it can hear you pluck your guitar strings, and tune your guitar by watching the inTuna display. The display will show several different indications about whether the pitch you are playing is sharp or flat. Start the inTuna application and place your iPhone near your guitar with the microphone facing your guitar. Pluck one string at a time and watch the inTuna display. The height of the orange bar on the left of the strobe window at the top indicates the volume the microphone is detecting. Make sure the correct indicator for the string you are tuning is displaying the pitch marker. You should see the white vertical indicator move to the left or right of center mark for pitches that are flat or sharp. Try to center the indicator by tuning up and down. For precise tuning, try to make the bars in the upper strobe window stand still; they are very sensitive to the slightest frequency change. At the bottom of the strobe display is the frequency measurement in Hertz and Cents (1/100ths of a semitone). If guitar resonance or background noise is causing inTuna to detect notes other than the one which you are trying to tune, try turning off Auto String Detect mode by tapping the Lock icon. When Auto String Detect mode is off, tapping on a note name on the main display will lock frequency detection to only that note; background tones will be ignored. If you have earphones plugged in, you can hear a reference pitch by tapping on the note names on the main display. With many guitars, tuning up to the correct pitch from slightly below the correct frequency works best. Try to make sure only one string at a time is sounding, as harmonics and overtones from other strings might capture the indicator's attention in unlocked auto-select mode. You might have to make multiple passes over all the strings, as tuning one string might affect the pitch of a string you tuned earlier. Alternate tunings and adjustments to the reference Concert A frequency are available in the Setting view, which is brought up by tapping the "Settings" button. If the display on your iPhone sleeps to conserve power, or if you get a phone call, the inTuna microphone input will be temporarily shut off to conserve power. You can (re)enable and disable the microphone using the Pause and Record buttons on the lower left toolbar. If the strobe display freezes or refused to operate, you might try rebooting your iPhone. Press and hold down the display-on/lock button on top of your iPhone until you see the message: "slide to power off". Power off; wait a second; and then press and hold the button again to restart your iPhone. -- HotPaw inTuna Guitar Strobe Tuner HD Six Simultaneous Precision Strobe Tuners for your guitar. Fast. Accurate. Noise resistant. Uses the built-in mic on your iPad. With 6 simultaneous strobe tuners, you don't need to wait for your room or recording studio to become quiet enough. You don't need to wait for a tuner to lock onto each note. You don't need to wait for a needle to finish moving. If you're really good, you don't even need to tune one guitar string at a time. With multiple strobe tuners, you can see if one string shifts in frequency while tuning another. You can also see if plucking a string hard on your guitar causes the notes to "bend". Just watch the waterfall waveforms overlaid on each string. When the waves for a particular guitar string synchronize or line up vertically, and stop leaning and shifting left (flat) or right (sharp), you are precisely in tune with an internal equally-tempered digital oscillator. For custom intonations, you can individually vary the reference frequency of each string in 1 cent increments up to +-20 cents away from equal temperament. The A440 reference is also adjustable. 8 alternate tunings (Standard EADGBE, Drop D, DADGAD, etc.) are supported, plus a special bonus Bass Guitar and String Bass mode. Version 1.1 adds a frequency readout with cents difference, 4 configurable custom intonation settings, and optional double-sized strobes for better visibility from a distance. Tap the Equal Temperament button to bring up the per string intonation settings. -- Learn to sing in tune with HotPaw Sing-inTuna Sing-inTuna uses the built-in microphone on your iPad or iPhone to help you visualize if your are singing or playing an instrument on the right note and approximately in tune. Sing-inTuna graphs the estimated pitch on a scrolling graph resembling a musical Grand Staff. Pitches that are within 20 cents of a true note frequency are highlighted in green on the chart, whereas off-pitch sharp or flat tones are colored red or blue. Sing-inTuna might also be helpful in assisting in the music transcription of very slowly sung or played notes with no background noise, music, percussion, chords, or harmony. (Only works for monophonic sound. You can use earphones to hear any accompaniment, if needed.) If you hit the pause/play button on the lower left corner of the display, audio recording will stop, and you can scroll back to review up to 1 minute of the history of the estimated pitch and note. You can tap on the lower right side of the staff to block spurious low notes. Also included is a darker display option, and a 12th-octave log-frequency Spectrogram mode so that you can see the harmonic content of any sound as it relates to musical notes. Using the built-in iPad and iPhone microphones, the pitch estimation range is approximately two octaves above and below middle-C, depending on the exact microphone positioning, sound volume, and spectral content. Pitch history is not saved. The estimated pitch accuracy can be measured against either Equal Temperament or Just Tempered frequency scales. Concert A frequency is adjustable plus or minus 10 Hz from 440. If you leave this application running for more than 20 minutes, or if you get a phone call when running this app on an iPhone, the inTuna microphone input may temporarily shut off audio recording to conserve power. You can (re)enable and disable the microphone using the Pause and Record buttons in the lower left corner of the display. -- HotPaw iChromatic Strobe Tuner HD 12 Simultaneous Visual Strobe Tuners for any instrument, fast, accurate, noise resistant, using the built-in mic on your iPad. Unique gorgeous waterfall strobe visuals show multiple note pitches or harmonics simultaneously. With 12 simultaneous strobe tuners, you don't need to wait for your room or recording studio to become quiet enough. You don't need to wait for a tuner to lock onto each note. You don't need to wait for a needle to finish moving. If you're really good, you don't even need to tune one note at a time. With multiple strobe tuners, you can see if one pitch shifts in frequency while tuning another. You can also see if plucking a string hard on a guitar causes the notes to "bend". Just watch the waterfall waveforms overlaid on each string. When the waves for a particular note synchronize or line up vertically, and stop leaning or shifting left (flat) or right (sharp), you are precisely in tune with an internal equally-tempered digital oscillator. If you are not sure if you understand using a waterfall strobe tuner, please download the Free inTuna A440 app from the App store (which can only tune 1 note: concert A = 440 Hz) and give it a try. For custom intonations, you can individually vary the reference frequency of each string in 1 cent increments up to +-30 cents away from equal temperament. The A440 reference is also adjustable. Notice: This app plays no piano sounds! It only allows you to visualizes sounds from the microphone input. -- The HotPaw iChromatic Strobe Tuner is an iPhone application which uses the built-in microphone on your iPhone to allow you to tune a musical instrument via visual displays. It includes both a frequency readout and 3 highly accurate and responsive waterfall strobe panes which allows extremely precise tuning. When the waveform patterns line up vertically as well as stop moving sideways in the strobe panes, this indicates that the input pitch (or a strong harmonic of the base pitch) matches an equal temperament on-pitch frequency. With the waterfall strobe tuning window, even very slight differences in frequency between the pitch which the microphone detects and the target pitch will cause the abstract waveform to waver or move sideways as it cascades down the strobe window. The top strobe pane is filtered to reject background noise. The second pane allows simultaneous viewing of a selected harmonic. The bottom pane is running at half the detected frequency to allow viewing of the 1st subharmonic. Also included is a pitch frequency readout in Hz and cents. Configuration options include a Concert A reference frequency adjustment. Manual mode allows you to lock the strobe tuner to a particular pitch. When first enabled, it locks to the current pitch being used by automatic pitch selection. You can adjust the selected note by the note up/down, and octave up/down buttons. In manual mode, you can adjust the frequency used by the strobe for each note by using a custom intonation table. This allows for either custom intonation, or piano stretch tuning. You can download a custom intonation text file from the internet by entering a URL for your table. The file should be plain text. The table can be embedded in a web page containing other html, as long as the table itself is embedded in plain text format. The actual table starts after the keywords: "IntonationTable:", without the quotes, and ends with the keyword "EndIntonationTable". The intonation table is a 2-column csv file. The first column is the midi note number, second column the cents offset to be used for that note. Any addition items (note names, etc.) on the same line are considered comments when downloading the file. In manual note select mode, you can adjust the per-note cents offset on-the-fly, or as you tune, by tapping on the strobe windows. Tap on one side to adjust the pitch offset up, and the other side for down. Tap the bottom strobe to zero the offset for that note. -- HotPaw Productions Talking Tuner HotPaw Talking Tuner is a hands-off, sound-activated, talking musical instrument tuner. It talks to tell you if you are in tune or not, so you don't even have to look at it. Talking Tuner uses built-in speech synthesis, and thus does not require that VoiceOver be enabled. I received a request to develop an iPhone app which could help a vision-challenged individual tune their musical instrument. This is the result. Talking Tuner can assist someone to tune a musical instrument without having to look at or touch their iPhone's display. With the Auto-Speak switch turned on, Talking Tuner will listen for a note to be played, and then, after waiting for the end of the sound (so as not to talk over it), will speak the note name, and how many cents sharp or flat the end of the note is estimated to be. Using headphones may help make it easier to hear what this app is saying while tuning. Make sure to turn the volume up high enough to hear it. The pitch estimation algorithm works best for notes between 2 octaves below Middle-C to 2 octaves above Middle-C. It may not work as well for very low notes, very high notes, or with any background noise, harmony, or accompaniment present. The accuracy is about +- 3 cents (3/100ths of the pitch difference between semitones). 50 cents is halfway between notes, or pretty much way out of tune. The Volume Threshold slider in Talking Tuner sets the sensitivity. Higher numbers will require a louder sound before the app starts to estimate the pitch. 3.0 is the default volume setting. -- HotPaw Music Pitch & Spectrum Viewer A 12th-octave musical-pitch-centered spectrum viewer for iPad See all the frequency harmonics from the real-time microphone input. Spectrum is displayed relative to an equal-tempered musical frequency scale. On pitch frequencies are highlighted in green when in tune (+- 20 cents). The 3 largest FFT peaks are interpolated for greater frequency accuracy readout, with the nearest note value any pitch error estimated in cents. A fundamental pitch is also estimated, if possible and when different from the frequency of peak amplitude. Frequency range is approximately 2 octave below middle-C to 3 or 5 octaves above, depending on the microphone used. The amplitude is in uncalibrated dB. Version 1.0.0 (build.08) - Initial Release -- The iAutoharp is easy and fun to play; just tap a chord button and strum to hear that chord played as sweetly as if on the actual 37-string instrument. The six chord buttons are initially set to the most common chords so you can get started right away, accompanying your singing or playing along on most popular tunes. You can play in any key, and more advanced players can reconfigure chord buttons to get any of a wide choice of less common chords - more than 150 chords for each key. The "strings" are on the left; swipe over them with your finger to play the chord (or try playing a melody by "pinching" different subsets of strings with your thumb and another finger). The chord buttons are on the right, with the currently selected one highlighted in red, and below them are buttons for changing the key and doing more advanced configuration. The top right chord button indicates the current key; that chord is the starting ("base") chord for the key. You can move ("modulate") to another key with the two arrow buttons (normally modulating up or down a fifth, such as from C up to G or down to F). The button at the bottom of the main screen takes you to the Settings screen, where you can reconfigure the modulation interval and the three chord buttons in the column closest to the strings. The Settings screen also includes buttons you can use to get more information about the iAutoharp or to go to the HotPaw Web site to check out our other cool products. The Modulate option on the Settings screen offers two choices: 5ths (the default interval when you click an arrow button on the main screen) and semitones (half steps, such as from C up to C# or down to B). The next three options on the Settings screen let you change the three reconfigurable chord buttons. (The chord buttons on the right on the main screen are very common and cannot be reconfigured.) These options show the chord button number and the chord currently set for each button; tap the one you want to change, and you'll go to the chord reconfiguration screen. The top of the reconfiguration screen shows the current chord followed by the notes that make up the chord. Below that are two independently scrollable lists from which you can select a different chord. In the list on the left is a notation indicating the relative position of the chord's root (starting note) in the current key, and the list on the right indicates the type of chord. Scroll either or both lists until the chord you want is under the selection bar. For example, for the A minor chord in the key of C, set "VI/vi" on the left (because the chord's root is the sixth note of the C scale) and "minor" on the right. (The Roman numeral is shown in both capital and lowercase letters because, by convention, it's capitalized for major chords but not for other chord types.) To change to E minor, scroll to "III/iii" on the left; to get a B diminished chord, scroll to "VII/vii" on the left and "dim.Triad" on the right. A "b" in the list on the left represents the musical flat symbol. Players familiar with music theory will notice that the choices in that list are a semitone apart, and will understand the abbreviated terms in the list on the right; others can learn more about the underlying theory from Wikipedia and other sources - or just set the chords and listen to how they sound on the autoharp. Some chords may sound odd, but if that's not what you want, you can always go back to the initial setting for a chord button by tapping Restore Default on the reconfiguration screen. -- Help File for the inTuna Concert A Strobe Tuner. A strobe tuner is a highly accurate way to determine whether a musical instrument is in tune, and to assist with tuning the instrument. The animated strobe window gives a highly accurate and responsive indication of the input sound frequency, relative to Concert A pitch (440 Hz). When the waterfall waveform patterns line up vertically in the strobe window, this indicates that the frequency, or a strong harmonic of the frequency, matches the reference, in this case 440 Hz. When the patterns shift to the right or left, this indicates that the frequency is sharp or flat. The waterfall waveform patterns in the strobe window are highly responsive and pitch sensitive. Very small shifts in frequency will cause visible shifts in the pattern. On the left side of the strobe window is a volume indicator bar. Above the strobe window is an estimate of the audio frequency and pitch in Hz. For certain types of sounds, the strongest frequency band picked up by the microphone is often a harmonic of the perceived pitch. The Setting Configuration view allows you to adjust the Concert A reference frequency by a +- 10 Hz, or to make smaller adjustments in Cents (100ths of a semitone). As a bonus option, you can also temporarily select to tune to the note Concert C (about 261.6 Hz in equal temperament tuning). The audio input will shut off after 10 minutes to conserve battery power. You can use the play/stop buttons on the bottom to reenable/pause sound input. -- HotPaw Audioalizer The opposite of an audio visualizer. Instead of creating images depending on the sound input, this app creates musical sounds depending on the camera image input. Works best with bright spots against a dark backgrounds, for example small white sticky-notes on a dark wall. Change the tempo and use it like a beat box. Or dance in black clothes with white gloves in front of the camera. -- HotPaw Morse Code Decoder Readme HotPaw Morse Code Decoder translates Morse Code sounds into text, using the built-in microphone on your iPhone, plus audio filtering and DSP signal analysis. The Morse Code Decoder includes a built-in spectrogram to detect the audio frequency of the Morse Code tones, and an optional narrow band audio filter to help filter out background noise. If the audio filter is enabled (frequency lock icon locked), the filter can be set for frequencies in the range of 400 to 1400 Hz. The filter can also be left off in a wide-band mode (frequency lock icon unlocked). An additional 2 kHz low-pass pre-filter helps eliminate QRM. Tap the spectrogram to set the audio filter to the frequency of the current peak signal. Tap the lock icons to toggle filter and WPM modes. The Morse code WPM (words per minute) detection speed is automatically adaptive from about 8 to 30 WPM, and can be locked to the current estimated WPM dot speed (WPM lock icon locked). It may take several initial and immediately preceding characters containing both dots and dashes before the WPM speed estimation starts to get close to the actual WPM. The AGC is automatic, but background sounds and signal fading can interfere with detection and decoding. The quality of detection depends on the signal level, signal to noise ratio, stability of the frequency and WPM speed, and keying "fist" quality. Only about the last 250 decoded characters are displayed in this version. The characters that can be decoded include International Morse Code for the 26 letters A-Z, the numerals 0-9, period, comma, forward slash, and question mark. This application requires the use of an external microphone on a 1st generation iPhone in order to get sufficient audio bandwidth and sample rates. This application requires the use of an external microphone on a 2nd generation iPod Touch, and will not work on a 1st generation iPod Touch. Version 1.6.2 Added a 2kHz audio low-pass pre-filter for better QRM rejection, and improved WPM measurement accuracy. -- LED Morse Code Decoder/Communicator Uses the LED flash to send Morse Code and the camera to receive and decode Morse Code flashes into text. Aim the receiving device until a sending devices flash is centered in the cross-hairs of the camera preview pane. Flash communication works best when the sending device is flashing in front of a very dark or black background. You may need a steady hand to keep the flash centered in the cross-hairs continuously. To send, select between the front display and the LED flash (when available). Type text in and hit "Flash Morse" to send. The Morse Code transmit/receive speed is settable from 3 to 10 WPM. Lower Morse Code WPM speeds may work more reliably. The WPM speed setting of the receiving device must be set identical to that of the transmitting device for the decoding to function properly. The first several characters received may be garbled while the camera input is calibrating the sensitivity level. (Use with other Morse Code flash apps is not recommended unless you know the exact WPM transmit speed.) Extended use of the LED flash may cause a significant decrease in battery life. version 1.0.0 -- HotPaw Text2Morse can translate text into Morse Code. Type in text, or download your own text files, and hear the result. Use this with the HotPaw Morse Decoder iPhone app for "secret" communication between two iPhones; transfer some text with no internet connection required. Just type some text into the text window, and hit the "Send Morse Code" button. Configurable audio WPM speeds from 5 to 40 WPM. On the settings page, you can select tone frequencies from 300 to 1200 Hz. The settings page also includes a button to download text from your chosen URL. If the text file on the internet that you plan on downloading is not a plain *.txt text file (something from your blog, for instance), use unformatted text, and put the prefix "MorseText:" just before your desired text, and "EndMorseText" at the end. Or use the HTML prefix "
" just before your desired text, and a "
" text after the end. Downloading text files requires an internet connection. Only a maximum of 8000 characters can be downloaded from a file in this version. Use on a 1st generation iPod Touch requires external speakers. Use of the LED torch flash feature on an iPhone 4 will cause a more rapid depletion of your battery. LED flash Morse code speed is limited to a maximum of 10 WPM. -- Morse To Text Tap on the knob in Morse Code to enter text. Email it. Or copy the text to use in other apps. No need to look at a tiny keyboard. If you know a little Morse Code, you can now enter some text without having to look directly at your iPhone. The Morse Code WPM (words per minute speed) is adjustable over a 5 to 45 WPM range so you can tap as fast or slow as you are capable. Both straight key and iambic keying (automatic dots and dashes) modes are supported. You can adjust the knob/dots to be on the left or right. Audio feedback is provided at a configurable frequency. If the timing of your keying (Morse Code "fist") is excellent, you can have the spaces between the words inserted automatically. Otherwise, this app provides a mode where spaces are suppressed. You can instead tap on the text field to enter a space, and stroke backward on the text field to delete mistakes. For audible Morse Code to text decoding, see the HotPaw app "MorseDecoder", also in the iTunes App store, which can listen for Morse Code sounds using the built-in microphone on your iPhone. -- Audio learning can be a great brain exercise. This is a Morse Code test generator which generates random 5-letter words and sends them in International Morse Code using your iPhone speaker. The WPM (words per minute) speed can be easily set. You can set the dot speed (as in the Farnsworth method), and tone frequency. You can also configure the number of possible letter and numbers used, as well as customize the list of letter and numbers from which the code groups are generated. 100 letter (20 5-letter words) are generated at a time, making it easy for you to score the percentage you can copy correctly. If you are just starting, go to the Settings page and set the number of characters used to just 2 or 3 at first. You can gradually increase the number of characters used as you become familiar with their sounds. It's been recommended that you set the Dot WPM speed to no lower than 13 WPM, so that you hear each letter more as one sound or rhythm, rather than individual dits and dahs. Hit "Start" to start sending a Morse code test. You can choose "Show", to see the letters displayed as they are sent to the speaker. This is helpful when first learning. After you are familiar with the sound of the letters, you can "Hide" the display of the characters sent, and attempt to copy them down on paper as your hear them. Then you can later show them in order to check how many characters you copied correctly. Supported punctuation characters include . , ? / - @ The $ symbol will generate the SK prosign. The + symbol will generate the AR prosign. The = symbol will generate the BT prosign. MorseTest Version 1.1.4 -- Help for HotPaw Basic for iPhone/iOS HotPaw Basic is a Classic BASIC language interpreter. Line numbers are required to enter and edit programs. You can edit a numbered line by using the "edit" command. (Please scroll this Help text to see more.) Type "help website" for more complete info. Commands and Statement Keywords: run new list del save load removefile let if then else endif dim data read restore for to step next while wend goto gosub return ? print input open close end stop def fn mat randomize cls : rem Functions: int() abs() sgn() rnd() sqr() exp() log() log10() sin() cos() tan() atn() len() val() asc() str$() chr$() hex$() mid$() ucase$() lcase$() right$() left$() field$() instr() eval() varptr() peek() timer() date$ time$ pi Operators: + - * / mod ^ = <> > >= < <= and or xor not Other special functions and commands: edit { line_number } dir removefile { filename$ } fn emailfile(address$, subject$, filename$) fn web(url$) fn vibrate() fn solve1() sound f,d,v : rem frequency, seconds duration, volume(0..99) morse m$ : rem plays morse code sounds fn fontsize(x) :' changes console font size Graphics: (This version limits graphics to the view above the keyboard.) moveto x,y lineto x,y :' draws a line to x,y fn linewidth(w) graphics color r,g,b graphics fillrect x1,y1,x2,y2 fn plot1() fn touch(1) :' x location in graphics display fn touch(2) :' y location in graphics display graphics cls :' clears graphics display cls :' clears both text and graphics On iOS AirPrint enabled devices, you can print by using: open "lpt1:" for output as #1 close #1 : rem print starts after file close Hints, Notes and Limitations: String variable names must end with a $ character. Arrays must be dimensioned before use. Input is line input. Only one variable is allowed per input statement. Function subroutines with return values are not supported. Hints: Use quotes around filenames with load/save. If you quit without saving a modified program, it's saved automatically in the file "tmp.bas". You can use fn emailfile() to email programs and files to yourself to save them on your PC. There are a few other, more advanced commands documented on the HotPaw website: http://www.hotpaw.com/basic/iphone or type "help website" into the console. -- Help for HotPaw Basic for iOS - Lite version The Lite version of the HotPaw Basic interpreter supports a maximum of 24 statement lines per BASIC program. Line numbers are required. Only 2 saved programs are supported, and they must be named either program1.bas or program2.bas Examples: save "program1.bas" and load "program1.bas" Also limited in the Lite version: Line graphics are restricted to a 160x160 area. Only 1 size of console font is supported. Function subroutines with return values are unsupported. -- Say Color for iOS Speaks the name of the nearest color in the center of a camera preview pane using speech synthesis. Can also show and speak the three RGB 255 numbers. If you lock the exposure and color balance (using the lock icon button in the upper right) while aiming at something medium neutral gray under your current scene's lighting, the color naming scheme will be more accurately centered in the RGB gamut. Version 1.0.0 -- HotPaw XOCubed - 3D 4x4x4 Tic Tac Toe Play Tic-Tac-Toe, not for 3-in-a-row, but for 4-in-a-row, inside a 3-dimensional playing field. Play against the computer, or a friend. There are 76 different ways to win in 3 dimensions, including 28 diagonals. Can you find all the ways to get 4 in a row and beat your opponent? There are options for choosing one-player or two-player mode, playing first or second in one-player mode, and selecting one of 10 different difficulty levels. Version 1.0.1 -- Last modified: 2011-Apr-12 --