The Well – v0.3.8.9

The Well v0.3.8.9 was released on June 17th, 2018.  This is the first release of the app since its initial release in 2016 and addresses some long-standing issues:

Bug fixes in v0.3.8.9:
  • Prior version could not import audio beyond the first file chosen, due to buggy code introduced into the import script just before the original release.  This has been fixed, unlocking a great deal of potential in the app:  now disorderly audio files can make their way into The Well and become neat, searchable libraries, just as intended.
  • Fixed recognition of invisible files (based on starting with a period, ".").  They will now be properly ignored when performing an audio file import.  This is especially helpful when importing audio from a non-Mac network share, such as Nexus/ISIS/Unity or a generic NAS.
  • Prior version had a very annoying habit of jumping to the first record after any search, making the first record the active record. Subsequently clicking on any other record's audio playback button would cause that audio file's duration to be assigned to the first record in the search, rather than the record clicked.  Playback on/off behavior became inconsistent for the same reason.  This was due to a subtle interface bug in FileMaker that requires a work-around.  As a direct trade-off of that work-around, after a search has been performed, you will now have to click on the search box to perform the next search, rather than just typing again.  Considering most people's search habits, this compromise will be an improvement.
  • After canceling Report Duplicates, you might have landed on a blank white screen.  This has been fixed.
  • Report Duplicates now lands in Maintenance Mode, displaying duplicate records.  Some future refinement to this workflow is being considered, but for now only a single set of duplicate records is shown, not the other records that match them.  Which record is considered the "duplicate" is a bit random at this time.
  • Automatically-generated log files, for example the report generated by an audio file import, now use timestamps in the YYYY-MM-DD_HH-MM-SS format so that they sort nicely in Finder.
  • Leading and trailing spaces are now allowed in Folder Prefixes (to better allow matching pre-existing disk filenames and paths to database filenames and paths).
  • In the Import Sandbox, clicking on Delete All Sandbox Records, Delete Marked Sandbox Records, and either of the  Import buttons now stops audio playback, which should prevent runaway audio playback with no button available to stop it.
New features in v0.3.8.9:
  • No new features.  Although the bug fixes rescued a major feature:  audio import!
Known Limitations:
  • When restoring or importing records from backups, The Well is excruciatingly slow to process the additions, especially when checking for duplicates.  This is partly a limitation of Filemaker's scripting environment, which processes steps in a less efficient manner than FileMaker's native functionality that you may be used to, and partly reflects a lack of development time to further optimize or re-think the import code.  Something for another day.  In the meantime, imports and backups will be something for you to run in the background while you are doing something else.
  • Favorites Lists must be restored after the records they reference have been restored.
  • Duplicates (same Group/Folder/Track/Description) will not appear if searching on a Group or a Folder (i.e.:  by clicking on the respective magnifying glass buttons), but will show up after clearing search.  This is a bug that will require some exploring.
  • Currently, only .mp3, .WAV, and .AAC (provisionally) files are listed & supported formats within the app.  Some testing needs to be done with alternate formats, time permitting.  If you are using the "source file" version of the app, you can add other formats (i.e.:  file extensions) in a hidden table in the app.

And that's it!

_______________

The Well – v0.3.8.7

The Well v0.3.8.7 was the initial public release in the Summer of 2016.

Known Bugs:
  • Audio File Import does not function:  only the first audio file is recognized and copied / processed.  A real bummer.
  • Canceling a Report Duplicates operation can land the user on a blank screen with no obvious way out.
Known Limitations:
  • When restoring or importing records, The Well is excruciatingly slow to process the additions, especially when checking for duplicates.  This is partly a limitation of Filemaker's scripting environment, which processes steps in a less efficient manner than FileMaker's native functionality that you may be used to, and partly reflects a lack of development time to further optimize or re-think the import code.
  • Favorites Lists must be restored after the records they reference have been restored.
  • Duplicates (same Group/Folder/Track/Description) will not appear if searching on a Group or a Folder (i.e.:  by clicking on the respective magnifying glass buttons), but will show up after clearing search.
  • Currently, only .mp3, .WAV, and .AAC (provisionally) files are listed & supported formats within the app.  Some testing needs to be done with alternate formats, time permitting.  If you are using the "source file" version of the app, you can add other formats (i.e.:  file extensions) in a hidden table in the app.

_______________

FileMaker “Source File” Notes

How to work with the FileMaker "source file" version of The Well:

Source files are available in either .fp7 (actually made in FileMaker v11) and .fp12 (actually made inFileMaker v14) format.  Download whichever version suits you and note the following:

  • To eliminate distractions and confusion when using the application, the standard FileMaker toolsets and menus are disabled upon starting the app (and subsequently re-disabled actively while using the app to keep things clean and neat and to protect the user).  To temporarily restore this functionality:
    • Upon launching the file, you will need to re-enable standard menus by selecting "Standard Menu Set" in the Custom Menus... menu.  As of v0.3.8.9, you will have to manually set this again as you navigate from window to window and invoke certain functions.
    • If you want the standard controls header (toolbar) on top of your FileMaker window, hit Command-1 to invoke a function that restores this toolbar temporarily.  As of v0.3.8.9, you will have to manually set this again as you navigate from window to window and invoke certain functions.
  • To permanently restore the Filemaker toolsets and menus requires looking into the script triggers of the app's various forms and finding the code that enforces the custom menu set and disables the toolbars.  Probably not worth the effort?
  • The plugins and helper apps – BaseElements, PlaySound and Gooey Gadgets – must be properly installed for The Well's operations to function (BaseElements is a hard requirement, the others are added wanted functionality).  The proper installation location and method for these helpers differs by version of FileMaker, so refer to online help sources to set things up properly in your environment.  Once they are installed, however, they need not be dealt with again and can be used actively in all FileMaker projects on the same machine.  BaseElements is especially helpful when scripting heavily.

Note that the file is complex to understand and will require some patience to reverse-engineer, even for a "power user."  Scripts are commented to help navigate the logical flow and are organized in folders by function type (User Interface / basic functions / file operations / etc.).

Good luck!

_______________