*"Best darn FM app": Yes, it has some bugs, and some device support issues, and may lack some of the "polish" of many stock FM apps, but it's the most functional and even the current RC1 has more settings than stock apps.
The ONLY FM app supporting ALL this: Equalizer, Effects, Recording, BT A2DP and Visualizer.
Spirit2 also supports multiple "remote" displays and controls: Home and lock-screen widget, lock-screen, notification shade, BT AVRCP and future Android remotes. AVRCP puts RDS and station info on the display of compatible BT headsets, and controls Pause/Play and preset selection. Was pretty cool the first time I saw that working.
If you've been happily using Spirit1 Unlocked for at least 3-6 months, please consider Spirit2 as a second purchase, for a next generation FM app. Help me give Spirit2 the 3+ year lifespan that Spirit1 has had so far. My income is still at the lowest end of "tolerable". Support me and I can support you.
The price is a bit higher than Spirit1 Unlocked. It will be dropped a bit on the 1st day of each month.
At Release Candidate #1 all known major bugs have been addressed. Please understand: software always has bugs, new ROMs can require new code and improvements are ongoing.
LG G2 D802 International and Sprint LS980 only. (Some stock, CM11 and Mahdi ROMs only as of March, 2014)
Motorola Moto G
*"Official Support" means I own the phone and I can properly support it.
**"Compatible AOSP" ROMs includes as many AOSP ROMs as I can reasonably support, that have the FM and audio kernel drivers needed to enable FM. CM11 is the most popular and best supported, except for the incompatible 2014 kernels for HTC OneXL LTE, OneS, and Evo 4G LTE. LG G2 is only supportable on CM11 and Mahdi ROMs as of March, 2014.
The only other devices with a chance of working fully are those with Qualcomm WCN3660 or newer compatible FM/BT/WiFi chips as well as Qualcomm WDC9310 or newer compatible audio chips. This includes most late 2012+ Sony devices starting with Xperia T. These may or may not work well, and are not officially supported. With sufficient demand I will consider buying a "Z" device and officially supporting some Sony's.
Spirit2 also works reasonably well on many stock or stock derived ROMs when rooted. But there are often problems, such as FM over BT issues on Samsung stock ROMs. Most of my customers are on AOSP/CM ROMs.
Digital FM Audio is possible, the Spirit way. Most higher end 2013+ phones are capable, as well as some lower end, such as Moto G.
Popular among AOSP ROM users. Galaxy S and 5 inch Note class flagships are the vast majority of Spirit2 and current Spirit1 Unlocked sales.
Higher end ; Inexpensive phones are great, but most apps are sold on high end devices.
I need to be convinced that the costs of purchasing this phone, PLUS the much greater costs of supporting it will result in at least a liveable wage. Just learning how to and flashing various ROMs can add up to hundreds of hours. Add fixing soft-bricks, learning the HW & SW, investigating, reverse-engineering, coding, and doing ongoing updates, fixes, workarounds and support and you get a glimpse of why Spirit2 support is limited to a handful of the most popular devices.
Ideally, the non-International North American variants support FM, at least in hardware. LG G2 and all Samsungs are a great disappointment here.
Every day I get MANY Spirit1 Unlocked debug logs in my email from pirates. Most of them come from less expensive devices, especially Mediatek devices from Huawei, ZTE, and much lesser known companies.
I have little interest in supporting phones that might earn me $100 if I got lucky, and would drown my email with even more pirate debug logs.
Status: Center of shiny frequency dial power icon is blue if on or grey if off.
Toggle: Tap center of shiny frequency dial where blue (if on) or grey (if off) power icon is.
On: Tap Play button at lower right or in widget.
Off: Tap square Stop button at lower left, in widget or in notification shade.
Auto on: Start app to automatically turn on FM.
Auto off: Start another music app and FM will automatically turn off.
Dial: Big shiny frequency dial displays and can be used to set frequency.
Blue Digital: Tap numbers to manually enter frequency.
Seek: Previous and Next buttons to left and right of Blue Digital display seek down or up to next strong station. Same for widget, notification shade, lock-screen and other remote controls, but ONLY when there are less than 2 presets programmed.
-/+: Left and right buttons below seek buttons tune down or up to next valid channel, depending on Band setting.
Presets: There are 16 presets at bottom. Press or long press a "+" to set or reset the current frequency as a preset. RDS names are now supported.
Preset -/+: When 2 or more presets are programmed, they can be navigated with the Previous and Next buttons for the widget, notification shade, lock-screen and other remote controls. With 0-1 presets, these are seek controls.
Status: Pause/Play button at lower right, in widget or in notification shade shows expected result of tapping it. Eg shows Pause if currently playing.
Toggle: Tap Pause/Play button to pause or play audio.
Status/Change: Tap speaker button at top right or use hardware or headset media buttons to display and change Music stream volume.
Status: Red button at top left is brighter when recording.
Toggle: Tap red button to change recording state. Files at /sdcard/Music/fm.
AOSP compatible equalizers, such as CM DSP Manager, can be accessed in ROM Audio settings, or with the Spirit2 on app "Menu" key (not the old style phone Menu keys). This key has 3 horizontal lines and is at low center between Stop and Pause/Play.
Some settings are accessible by swiping from right to left to access a window to the right of the main window.
UI Visual: To replace the frequency dial with a waveform and spectrum analysis visualizer.
Band: Use "USA" in North America or "EU+" everywhere else.
Tuner Stereo: Stereo 2 channel when checked or Mono when unchecked.
Tuner AF: Alternate Frequency switching enabled when checked.
Audio Stereo: Distinct from Tuner Stereo and can lower CPU load and recording size.
Audio Speaker: Experimental Speaker mode works on some phones but may have volume control issues.
Other settings: none at this time.
Debug log sending is experimental.
Remote display and controls: for lock-screen, notification shade, widget, wired headset media buttons and remote controls and info display via BT AVRCP.
Speaker output experimental. Workaround: remove wired headset plug enough to switch to speaker, but still inserted enough for a good antenna connection.
Before 2013, most FM radio audio on Android phones was "mostly analog"*. FM audio bypassed the digital audio chain and was injected in the final stages, after the final D->A conversions.
FM audio was a special path that did not follow the same rules as every other source of audio on Android. Hundreds if times I've heard "... but it works fine with music players etc." and I explained how FM is different. Fm audio usually can not be equalized or modified with effects. It usually can not be recorded, visualized, or routed to BT headsets.
Besides lacking these digital audio features, "non-digital"** FM audio is difficult to do on AOSP ROMs. AOSP usually does not use the stock audio libraries that contain support for FM. This has been a never ending source of grief and work for me; I spend at least 50% of my development time on audio issues as a result.
Basically, Spirit will use SU/root low level functions to set up the audio hardware for FM, via kernel device driver commands for ALSA or earlier APIs. But the ROM audio library has no idea that FM is running. This can often result in conflicts that break audio, especially during audio notifications. On some popular older devices, such as HTC Desire HD, I had to create a hack that resets the entire audio system when FM is turned off. And users just have to live with the fact that audio notifications break audio, at least until FM is turned off or the device is rebooted.
There were many other problems, including a need to continuously loop a silent audio file, to convince the audio libraries that music was playing. Otherwise, volume control was lost, among other things.
This was rarely a problem on CM7 ROMs that included a CM FM app, because the audio libraries supported FM. But most CM9 ICS and later ROMs dropped support for FM. I considered making code contributions to CM and other ROMs to fix this problem the proper way, in the audio libraries. But I concluded this would take all of my time, may create personal conflicts and might never cover the majority of ROMs anyway.
*"Mostly" analog: Surprisingly, just about every FM chip does internal signal processing digitally, after the initial A->D conversions, Frustratingly, virtually every 2012- phone did not use digital outputs, where they existed, but converted the Digital left and right audio back to analog.
"Non-digital"**: I do not use this term to strictly mean "Analog". I use it to mean a method to enable FM audio that stock OEM FM apps use, and that Spirit1 uses, when not using one of the "Digital..." Audio-> Method settings. At the chip level, the audio may be digital, as is the case when using Qualcomm FM/combo chips with Qualcomm WCD9310 or compatible audio chips.
Spirit's Digital Audio Solution:
A digital solution to most of these problems was envisioned in late 2012, and resulted in the 1st prototype alpha releases of Spirit2 in early 2013. Spirit2 was digital only and this proved to be a much easier way to do FM audio, with few problems. When it became clear how much more work was needed to complete Spirit2, and given that Spirit1 continued to sell well enough to live, digital audio was "back ported" to Spirit1.
Here's how it works: Instead of just sending a few commands to the audio drivers, Digital audio mode sends different commands to enable digital, then continuously reads the ALSA PCM channel. All audio data read is then written to the Android Audiotrack API, the same as most streaming apps do. A streaming app reads from the network; but Spirit reads from the FM/audio chip.
The main disadvantage of this digital audio method is higher CPU and battery consumption. OTOH, "non-digital" audio on most AOSP ROMs required a constantly looping silent audio file anyway, so the difference is minimized.
Another digital disadvantage is that some devices can experience brief audio drop-outs. This does not affect Samsung devices. Full and partial workarounds include modifying CPU frequency or kernel scheduler. Tuning and investigative work is ongoing.
There are also challenges for speaker mode. The current support is experimental and does not work on all devices. But the current code is much cleaner and much more robust than Spirit1 non-digital audio, which can have issues during phone call interruptions. Volume control can also be unusual over speaker. The reason for these problems is that Android is designed to switch to speaker only when the wired headset is unplugged. But FM is unique: the wired headset is used for the antenna. A workaround for motion-less devices: remove the wired headset plug just enough to switch to speaker, but not enough to lose the antenna affect.
But the advantages of this form of digital audio are HUGE, IMO. They have allowed me to provide all the audio features people had been asking for: recording, equalization, effects, A2DP BT headset and visualizers.
AND it allowed me to minimize the MANY FM specific audio problems with much smaller, better designed and better written code, with a minimum of special cases. The Spirit1 audio (and other) code is a huge mess and can never be re-written IMO.
Audio dropouts on non-Samsung devices made me consider non-digital audio methods in Spirit2, despite the work and complications that would create. But a variety of fixes and re-tuning has improved audio, workarounds have been identified and work is ongoing.
The advantages of digital only are too great IMO to "pollute" Spirit2 code with non-digital audio. I've even removed previous non-official support for stock Sony devices in order to concentrate on digital audio that is as flawless as possible.
Samsung devices only rarely have audio drop-outs. I've only seen this on the oldest, now "vintage" original Galaxy S GT-I9000, and only when recording, at the same time that the equalizer, effects and the visualizer are all running. The old single core CPU gets close enough to it's processing limit that very occasional ticks may be heard, but the recording is usually fine.
LG G2 and Moto G are working pretty well now. The worst affected are the HTC One and the HTC OneXL/S/Evo 4G LTE, or other Qualcomm FM+audio devices. Further tuning and investigation is ongoing, but these things can minimize the problem:
Turn screen off.
Disable visualizers or any other app or service that might be using CPU resources.
Disable equalizer or other audio effects. Bass-boost and EQ alone don't seem too bad.
Raise CPU minimum and/or maximum frequency (Only if you understand the risks of CPU burnout.)
Change CPU scheduler: Performance risks CPU failure; Interactive or Pegasusq may be better.
Set Band to "EU+" after swiping from right to left to reveal right side settings. Default is "EU+" unless ROM identifies location as North America.
Where are recordings ?:
See /sdcard/Music/fm for WAV files named with parseable start time. Compression to MP3 files will be considered in future. Maximum of 4 GB results in 5-10 hour maximum time, depending on sample rate (22-48 K depending on phone).
Speaker does not work:
Experimental at present. Workaround: remove wired headset plug enough to switch to speaker, but still inserted enough for a good antenna connection.
Speaker volume control broken:
Experimental at present. Turn Screen off or use on app volume.
Phone call problems:
Avoid speaker mode
Avoid removing or inserting wired headset while FM or phone call is active.
Why a commercial app ? :
Because donation models just don't work in the long run. CM went commercial to better thrive and the same for Spirit. Spirit would have folded after 1 year, instead of the 3+ years it's been going, without app sales at a decent price.
Both Spirit1 Unlocked AND Spirit2 ? :
I NEED your financial support, so if you can afford it, I appreciate those who purchase both. See post below for a list of differences.
But if you are a paid customer for one of these apps, I can send you test copies of the other here and there. This might be for trouble-shooting, or to gain features or avoid certain bugs.
Open Source ? :
Nothing yet, other than a few example snippets and an App Inventor app that nobody seems interested in.
At some point, everything will be released, as I've done with other projects. X years after I pass away, or at some time I find appropriate.
I may release portions, to allow 3rd party FM or audio chip plugins, 3rd party apps or whatever. Convince me that it's in my (and Spirit's) interest.
Any version I release as Free, as described in this thread, can be re-distributed in a ROM, as long as there is no misrepresentation, or fee charged for the ROM, or combo of phone and ROM or whatever I deem.
Any versions which I do not identify as Free must not be distributed, sold, or otherwise "spread".
Free versions will be the exception, rather than the rule, at least at this time. I owe it to Spirit, myself and all of you to keep Spirit alive as well and as long as I can. Please support as best you can; I still get occasional Paypal donations, to firstname.lastname@example.org and I appreciate all of them.
Features may be added as demand and time available indicate. As of March 2014, Spirit1 Unlocked still has features that Spirit2 does not.
But Spirit2 will likely not get EVERY feature that Spirit1 Unlocked has. It seems better to me to focus on the most commonly requested features. Time available for adding features is always in short supply, with the constant flow of new ROMs creating a constant flow of new problems to solve. Spirit2 is focused more on quality than feature quantity.
As of March, 2014, Spirit1 Unlocked has pretty much every feature that Spirit2 does. Exceptions include an OFF button in the widget and notification shade, which is exclusive to Spirit2.
So I'll list features that are exclusive to Spirit1 Unlocked:
Spirit1 Unlocked exclusive features:
Stock, unrooted device support. Spirit2 will likely never add this feature, due to the low level of interest and the "Death of access to 3rd party FM APIs" as posted.
Settings, especially Debug. Spirit2 attempts to automatically set as much as possible, visibly or not. Spirit2 WILL get more settings, as time available and demand indicate.
Speaker mode. Still experimental on Spirit2, with issues.
I prefer that Spirit2 problems be reported publicly on this XDA thread. I almost always reply to thread posts before dealing with my email.
If you are using a Free version, I generally prefer that you not email me.
I've disabled XDA PMs; I got tired of "private requests for support" from non-customers. If it's important, email email@example.com .
If you're a customer and you post, let me know if I don't know you. I may be more likely to help and flash your ROM to test or whatever. These things take time and time is short.
If you're a customer and you email, and we haven't exchanged email before, please give me the email of purchase, or better yet the order ID. Some people DO pretend to be customers, and are not. Google used to make it easier to search customer records, but in the name of privacy, it's now hard to search.
Always include your phone model and variant (eg ATT version), and the ROM you're running. For Spirit2 I'll presume you are rooted at least.
I have no crystal ball, but the trend seems downward.
Attempts to standardize on an FM API for Android have all failed.
Future of Spirit:
From the perspective of Spirit, financial support has been strongest from owners of high end Samsungs, since I added support for GS1 in 2011 and GS2/Note in 2012.
We've now seen 3 flagship phones from Samsung on which FM is impossible to enable (very purposely): GS4, Note3 (except the very rare Sprint variant) and now GS5. Thus my primary sources of financial support are drying up.
The only 2013 devices that are officially supported by Spirit2 are LG G2 and Moto G, and sales on these devices is sadly tiny. And I'm not seeing any 2014 devices so far that I would be able to officially support, though I will keep an eye on the Sony Xperia Z2.
It does not help that all Nexuses (except the now ancient Nexus One) also have FM permanently disabled in hardware (very purposely).
I am further troubled that both HTC and Samsung have disabled 3rd party access to their FM APIs. It's impossible now for Spirit1 to work on the latest stock Note3 and HTC One ROMs. I experimented with Samsung stock API support in Spirit2, but have now removed the code; it's useless to fight the trend.
Add the fact that Google is adding security features to Android that are IMO welcome, but are making things more and more difficult for root apps. At least AOSP ROMs like CM11 tend to be more welcoming.
How long can I keep Spirit going ? :
I currently make income that's around the low end of liveable. My long hours make it about the minimum legal wage here. Employers pay 5 times as much in my field, plus benefits and vacations.
My income was "decent" in the spring of 2012 when I stopped posting a free version on Play, added GS2 support and raised the price of Spirit1 Unlocked to about $10. Since the spring of 2012, my income has dropped, pretty much every month, to a bit more than half it's peak. See my pricing posts if you think I can "make it up with volume" by lowering the price.
Introducing Spirit2 has induced a small bump. Please help me bump it higher... I hope I can keep Spirit going full time until at least the end of 2014, after that things get fuzzier.
My niche (OTA FM radio) within a niche (AOSP ROMs) is narrow enough that I have pretty much ZERO paid app competition. Worse, it's getting narrower as time marches on. Nobody else has been "crazy" enough (and/or capable enough) to try this. But it's narrow enough, and narrowing fast enough, that I have to acknowledge it.
So, as a responsible, home owning adult, parent and husband, I have to start investigating other app opportunities. If/when my income drops sufficiently I may have to devote more time to other projects. Perhaps in the areas of audio, Bluetooth, AOSP and even wearables.
I understand that many pirates can't afford, or would never support Spirit. That's life, that's economics; it must be accepted.
If the piracy rate was 90%, then converting just 10% of the pirates into customers could double my income, and keep Spirit2 going for at least the 3 year life that Spirit1 has so far.
XDA Developers was founded by developers, for developers. It is now a valuable resource for people who want to make the most of their mobile devices, from customizing the look and feel to adding new functionality. Are you a developer?