Guide to running SwordSearcher on Linux operating systems

SwordSearcher 9.1 running on Ubuntu 22.04

I’ve written a Guide to Running SwordSearcher on Linux Operating Systems.

While SwordSearcher is designed for Microsoft Windows, many SwordSearcher users, or potential SwordSearcher users, have asked if there is a version for Linux operating systems.

There is no Linux version of Windows, and you can view the system requirements here. What I recommend is using a virtual machine like VirtualBox to run Windows applications on Linux, but that is not always an option for people and does require one to purchase a Windows license.

However, it is technically possible to run SwordSearcher on a Linux system without a virtual machine, using a tool called Wine, which stands for “Wine is not an emulator.” Wine is a way to run some Windows applications on operating systems like Ubuntu.

Getting SwordSearcher to work with Wine is a matter of patience and persistence. While I cannot provide a guarantee of support for using SwordSearcher this way, I have written a guide to setting it up.

Please see this forum post for the full guide, and be sure to read all the way to the end for some caveats.

Guide to Running SwordSearcher on Linux Operating Systems

SwordSearcher’s 30 Year Anniversary!

“But my God shall supply all your need according to his riches in glory by Christ Jesus.” –Philippians 4:19

In 1994, I started a simple programming project for Bible searching. I had no idea at the time that I would still be working on this tool 30 years later!

When I released SwordSearcher 9.1 a few weeks ago, I didn’t realize I was releasing the 30th anniversary edition of the software, and it only occurred to me this morning.

It’s highly unusual for small projects to last this long, and I wanted to thank all of you who continue to use and support SwordSearcher, who made this possible. Throughout my career as a Bible software programmer and publisher I have seen a dozen alternatives come and go. It pleases me greatly that SwordSearcher is still here and is still found to be useful and interesting to so many people.

Over the last decade we have seen a trend towards “software as a service,” with most large software suites requiring annual subscriptions rather than offering perpetual licenses. While this method of selling software makes sense for many programs, I am happy to say that I have not had to resort to this revenue method for SwordSearcher. You can still make a single, one-time purchase of SwordSearcher to use it indefinitely, and choose whether to continue to support the project by purchasing upgrades when they become available.

The reason this works is because you are supporting a small family-run company, not a large corporation with huge overhead. And it works because many users of SwordSearcher continue to support it by purchasing upgrades, so thank you!

The response to the recent release of SwordSearcher 9.1 has been overwhelmingly positive. Many of you have written kind and encouraging messages to me over the last two weeks, and while time doesn’t permit me to write detailed responses to each of those messages, please know that I genuinely appreciate them. They are genuinely helpful!

So once again, thank you for using SwordSearcher!

By the way, if you’re curious about the history of SwordSearcher, I have an article about it right here.

By the way, astute observers will note that I called 2015 the 20th anniversary of SwordSearcher. The minor discrepancy is explained by the fact that the first version, 1.0, was actually called “Bible Assistant.” The Bible Assistant help file named SwordSearcher as the upcoming release, which was announced and beta tested in 1994, but made available in 1995. This time when I was thinking about how long I have been developing this software I decided just to go with 2024 as the 30th anniversary. I hope nobody minds too much!

SwordSearcher 9.1 Released

Screen shot of the newly enhanced Topic and Verse Guide in SwordSearcher 9.1

SwordSearcher version 9.1 is now available!

Current users of SwordSearcher can upgrade at a discount here. Read below for the details or visit the Upgrade FAQ for more information.

New modules:

  • James Hastings’ Great Texts of the Bible (commentary) [jhTexts], 1910-1914. A 20 volume work of extensive topical and expository content.
  • Lange’s Commentary on the Holy Scriptures [Lange], 1871-1899. A 63 volume commentary translated into English under the supervision of Philip Schaff. This commentary is presented in a “chapter-based” format to preserve the flow and intent of the author.

Enhanced Topic and Verse Guide:

  • Added new preview pane to the Topic and Verse Guide. This is a big time-saver and study-flow efficiency enhancement!
  • The preview pane shows the content of items as you click on them in the results, without having to change your positions and navigation history in the main Commentary and Book panels.
  • The preview pane can be toggled on or off and this setting is remembered between sessions.
  • If the preview pane is visible, double-clicking an item will cause it to load in the main viewer, or you can click the heading in the preview pane. (Ctrl+Click will open the entry in a clone panel.)

Other enhancements:

  • Added “Line Height” setting to Preferences, Fonts and Colors. This allows for fine-tuning the text density in the Bible, Book, and Commentary panels. This setting replaces the old “Optimize line height for touch” setting.
  • Added keyboard shortcuts for rotating tabs. Ctrl+Alt+Left and Ctrl+Alt+Right. Using this when a Bible, Book, or Commentary panel is focused will rotate through relevant open tabs in the panel.
  • Added “Open in Topic Guide” button to Verse Guide Panel.
  • Improved initial start-up time.
  • Reduced memory and resource consumption.

Fixes:

  • Fixed a potential crash in the Topic Guide after deleting a user module.
  • fixed a rare condition where a crash could occur when closing a panel or the application before the text was finished loading.
  • fixed: clicking a link in a clone panel that was not active/focused would sometimes ignore the link click until it was clicked a second time.
  • fixed Clear Bookmark function not updating bookmark menu captions immediately.
  • fixed right-click menu of Image Viewer tree (left panel) not appearing
  • fixed: disabling all toolbars and then restarting causes the empty space for the toolbar to show.
  • Other stability improvements and minor bug fixes.

Included from previous hotfix releases:

  • Added audio Bible timing support for the latest 128kb and 192kb voice-only Scourby.com mp3 files (2021).
  • Added audio Bible timing support for an Max McLean Listener’s Bible from christianaudio
  • Fixed a potential crash when importing invalid reading plan templates.
  • Fixed a crash that could happen when changing color modes from the main View menu.
  • Fixed possible error condition when trying to clone a user book panel from an empty user book
  • Fixed possible error when setting active verse or currently narrated verse visual style (background color)
  • Fixed possible error when saving user module
  • Fixed bookmarks and clone panels not always properly restoring scroll position on systems using a comma as a decimal separator
  • Fixed an issue with verse autopaste (Ctrl+Alt+V)
  • Fixed: if a bookmark was set from the main Bookmarks menu (invoking dialog), the bookmark menu item caption wouldn’t update until the next time SwordSearcher was started.
  • Fixed mouse wheel not scrolling tree view in Images viewer
  • Fixed clone panel content links sometimes not resolving to the correct module.
  • Fixed: in the editor, a manually created href link could cause the program to freeze when switching to the code editor if it was missing a closing quotation mark.
  • Fixed: Minor UI issues
  • Other minor enhancements.

SwordSearcher 9.0 Hotfix 2 update available

SwordSearcher 9 has a free update, version 9.0.3.23108. This update includes:

  • Added support for additional digital editions of Scourby and McLean audio Bibles.
  • Fixed an issue with the preferences configuration window.
  • Improved visibility of the Quick Concordance “new” tab.
  • Fixed possible error condition when trying to clone a user book panel from an empty user book.
  • Fixed possible error when setting active verse or currently narrated verse visual style (background color).
  • Fixed possible error when saving user module.
  • Fixed bookmarks and clone panels not always properly restoring scroll position on systems using a comma as a decimal separator.
  • Fixed an issue with verse auto-paste (Ctrl+Alt+V).
  • Fixed: Changing the color mode from dark to light and then closing could cause harmless but unwanted Windows crash dumps.
  • Fixed a potential crash when importing invalid reading plan templates.
  • Other minor fixes.
  • Some speed optimizations.
  • Minor help file corrections.

What’s a “hotfix?”

A hotfix is a minor update to fix bugs that were discovered after the official release. It is strongly recommended that you install the hotfix to keep your SwordSearcher experience as good as it can be.

How can I get it?

Just open SwordSearcher and go to the Help menu, and choose Check for Updates. This will show you any updates available to you and give you a download link, if applicable.

Check for Updates in SwordSearcher

That’s the preferred way to check for updates. You can also directly download the hotfix here:

Download: SwordSearcher-9.0.3.23108-Hotfix.exe (26.1 MB)

If you’re using a version of SwordSearcher prior to 9.0, be sure to read about what’s new in 9.0 and get your upgrade here.

SwordSearcher 9.0 Hotfix 1 update available

SwordSearcher 9.0 has a free small update (version 9.0.2.21104), which has the following fixes since 9.0 was released:

  • Fixed: if a bookmark was set from the main Bookmarks menu (invoking dialog), the bookmark menu item caption wouldn’t update until the next time SwordSearcher was started.
  • Light mode menu text color fix on Windows 11.
  • Fixed some UI painting issues.
  • Fixed mouse wheel not scrolling tree view in Images Viewer.
  • Fixed clone panel content links sometimes not resolving to the correct module.
  • Fixed search result panel captions changing to long format when layout was reset or changed.
  • Fixed: in the editor, a manually created href link could cause the program to freeze when switching to the code editor if it was missing a closing quotation mark.

What’s a “hotfix?”

A hotfix is a minor update to fix bugs that were discovered after the official release. It just fixes some issues; it doesn’t add any new features. It is strongly recommended that you install the hotfix to keep your SwordSearcher experience as good as it can be.

How can I get it?

Just open SwordSearcher and go to the Help menu, and choose Check for Updates. This will show you any updates available to you and give you a download link, if applicable.

Check for Updates in SwordSearcher

That’s the preferred way to check for updates. You can also directly download the hotfix here:

Download: SwordSearcher-9.0.2.21104-Hotfix.exe (15.4 MB) (Note, this hotfix has been superseded by hotfix 2.)

If you’re using a version of SwordSearcher prior to 9.0, be sure to read about what’s new in 9.0 and get your upgrade here.

Quick tip: Clone panel from the Topic Guide

If you’re using the Topic Guide to find more information on a given topic, sometimes it can seem inconvenient to look at the material, because by default, it will move your Book or Commentary panel content away from what you may be reading.

There’s an easy way around that: Clone Panels (see the Help section). The way this works is instead of moving your Book panel to the content you clicked on, a new window is created instead, leaving your Book Panel alone.

Clone Panels have been part of SwordSearcher for years, but version 9 adds the ability to create a clone panel from the Topic Guide by right-clicking the entry title and selecting Open in a Clone Panel from the menu. This makes it super easy and fast to review a lot of material on a topic without changing the course of your current Bible study.

SwordSearcher Topic Guide

Cloned panel containing topical content

Also, you don’t even need to right-click. Hold down the CTRL button while you click the link, and SwordSearcher will open the content in a clone panel.

SwordSearcher 9 Released with Dark Mode and more

SwordSearcher 9’s new Dark Mode interface

After a considerable development period, SwordSearcher 9 is finally available!

There are a couple of new library modules, as usual, but the real improvements are to the program itself. Version 9 adds a dark/light color mode toggle that lets you quickly adjust the color mode of SwordSearcher’s interface for when you’re working late and night in a dim environment or just trying to reduce eye strain. Check out the comparison of color modes here. What’s great about the color mode toggle is that it remembers your text and background color choices for each mode, independently. This means you can set up your favorite colors for each mode and not have to worry about losing them when you switch!

In addition to that, some serious work has been put into improving SwordSearcher’s layout and windowing systems.

Moving your study panels around in the main window is easier now because panel sizes automatically adjust to expected sizes when you move them, and all of the panels will proportionally size, automatically, when the main window is maximized or restored or otherwise resized. Setting up a custom layout should be faster and easier now.

Also, tool windows like the Topic Guide and English-Strong’s-Indexer now appear to the system as “top-level windows,” which means they can all be maximized, minimized, and most importantly, they now participate in Windows Alt+Tab task switching and Windows Snap functionality.

Clone panels have had an upgrade, too. You can now create clone panels that can be maximized, minimized, snapped, and Alt-Tabbed. (If you prefer the prior functionality of dockable clone panels, you can have that, too!)

We’ve also been using Microsoft’s preview builds for Windows 11. Not surprisingly, to really shine on a new version of Windows, we had to accommodate some new and changed features of Windows 11. That work has been done, and SwordSearcher 9 runs and looks great on Windows 11, which is expected to be released to general availability later this year.

There’s a bunch more stuff, including hundreds of little improvements and tweaks too numerous to mention. Rest assured though, SwordSearcher 9 is still SwordSearcher and you will feel right at home when you upgrade.

Speaking of upgrades, if you’re already a SwordSearcher user with a valid license, you can get a huge discount on the new version right here.

More information:

SwordSeacher 8.4 Released with new Quick Concordance Tool and more

We’ve got two new commentaries (34 volumes worth of content) and lots of great enhancements in SwordSearcher 8.4. A new search tool has been developed, called the Quick Concordance. The Quick Concordance is a fast way to do “on the side” searches that don’t interrupt your study flow. It’s updated live as you type and it’s instantaneous, offering an unlimited number of new “concordance tabs” in a floating window. The QC has been integrated into StudyClick and the various pop-up menus for fast access and seamless use.

Also, SwordSearcher has had an analytical concordance tool called the English-Strong’s Indexer for many years. For version 8.4 it’s had a complete overhaul and redesign to make it faster and more flexible.

See the complete list of updates below. If you’re a SwordSearcher user already, go here for your upgrade.

New Library Modules:

  • William Godbey’s Commentary on the New Testament [Commentary module: Godbey] (7 vols, 1910)
  • Joseph Parker’s People’s Bible Commentary [Commentary module: Parker] (27 vols, 1886-1898)

New Quick Concordance Tool:

  • A convenient new way to perform quick, “on-the-side” Bible searches without opening new verse list panels.
  • Floating tool window supporting an unlimited number of search tabs.
  • Instantaneous results display in the classic concordance layout as you type your searches, making it super-easy to get word and verse counts, without disrupting your current study flow.

Enhanced English-Strong’s Indexer:

  • SwordSearcher’s analytical concordance tool, known as the English-Strong’s Indexer (aka ESI), has been redesigned and expanded.
  • The ESI can now work on small phrases and Advanced Search Expressions; it is no longer limited to using a single word only.
  • By default, the ESI now includes multiple word forms in its matching.
  • To make the ESI more powerful as an analytical concordance, it now accepts Strong’s numbers as well as English text.

Other improvements:

  • The Bible panel book and chapter menus have been enhanced.
  • StudyClick improvements.
  • Verse List bar graph now allows clicks on books that have no matches. Doing this will bring the closest match position into view, so the bar graph can more easily be used to quickly navigate the results, without having to precisely click on a bar with results.

Many more enhancements and several bug fixes. All of the details can be seen here.

SwordSearcher 8.3 Released with Enhanced Audio Bible Support

SwordSearcher 8.3 is now available!

In addition to some great new library content, the big update in this release is enhanced Audio Bible support. There are now several narrations supported by SwordSearcher’s audio Bible integration and you may link in as many audio Bibles as you have on your hard drive.

If you’re a SwordSearcher user already, go here for your upgrade.

What’s New in SwordSearcher 8.3
Q2 2019

New Library Modules:

  • James Nisbet’s Church Pulpit Commentary [Nisbet] (12 Vols, 1908)
  • Handfuls on Purpose [Handfuls] (James Smith and Robert Lee, 13 volumes, 1943)
  • The Essential Works of A. W. Tozer [AWTozer]
    (Nine books from the life and ministry of A. W. Tozer, 1897-1963)
    One combined SwordSearcher book module:

    • Christ, The Eternal Son
    • Jesus is Victor
    • Jesus, Author of Our Faith
    • Jesus, Our Man in Glory
    • Knowledge of the Holy
    • Man, The Dwelling Place of God
    • That Incredible Christian
    • The Pursuit of God
    • The Root of the Righteous

New and enhanced Audio Bible Support:

  • SwordSearcher has supported the integration of an audio Bible for several years, but this functionality has been significantly enhanced for SwordSearcher 8.3.
  • The following Audio Bibles are now supported with verse-level synchronization and playback and can be directly played from the Bible panel and Verse List panels:
    • Alexander Scourby, KJV, AMG Publishers.
    • Alexander Scourby, KJV, Hendrickson Publishers.
    • Alexander Scourby, KJV, Scourby.com (non-dramatized mp3 edition only)
    • Max McLean’s Listener’s Bible, KJV, Fellowship for Performing Arts.
    • David Cochran Heath, KJV, ChristianAudio.
    • Paul Mims, KJV, AudioBible.com.
    • Dan Wagner, KJV, Talking Bibles International.
    • Faith Comes By Hearing Dramatized KJV.
    • Stephen Johnson, KJV, Firefighters.org.
    • Note that SwordSearcher does not come with an audio Bible. You may integrate any of the above audio Bibles into SwordSearcher once you have obtained them from their publishers or retailers. Please see the audio Bible page on the website for a complete list of supported audio Bibles and where you can obtain them.
  • You may now configure an unlimited number of audio Bibles at the same time. Switching between integrated audio Bibles is easy and done with a simple selection in a list.
  • Audio playback speed can be adjusted to make it slower or faster based on listening preference.
  • The core audio system has been replaced and updated to work with a wider variety of source audio files.
  • Audio Bible configuration/selection is accessible on the main File menu or with Shift+Ctrl+A keyboard shortcut.

Other improvements and fixes:

  • Added visual feedback for clicking on a verse widget or margin link.
  • Word Trees now remove hyphens from hyphenated words. This allows Word Tree searches and links to work consistently regardless of hyphenation setting in Preferences.
  • Verse Guide panel will automatically rebuild its content after saving changes to a user module entry.
  • Improved parsing of hard-coded verse reference links in user module entries.
  • Fixed issues related to “Remove optional hyphenation” option.
  • Fixed some tab display issues that could occur after renaming or deleting user modules.
  • Fixed a condition where the user editor would not allow saving until more changes were made after switch to Design mode.
  • Fixed incorrect counts and ratios in Bible Search Result Info and Stats for Verse Match Count by Book.
  • Fixed: Renaming a user module could orphan its keyboard shortcut.
  • Fixed a condition where user module editor Insert Table dialog could get hidden behind the editor.
  • Other various minor fixes and optimizations.

Navigation tip: Switching between book tabs and the history menu

SwordSearcher’s Books and Dictionaries panel is designed to help you review similar materials in different books. For example, if you’re viewing the Nave’s Topical Bible entry on Anathema Maran-atha, the Watson’s Dictionary tab is highlighted, and clicking on it will take you to the Anathema Maranatha entry in that dictionary. This works even though the two books use different titles. Note the subtle difference of the hyphenation in Maran-atha.

This is possible because SwordSearcher has a special “best match” algorithm it uses when you switch between book tabs. Minor spelling or orthographic differences don’t typically present a problem for reviewing similar material because of this feature.

However, if you switch between books that do not have similar entries, it is possible to “lose your place” if you don’t realize what is going on. For example, if you’re reading a book comprised of chapters instead of a dictionary, it’s not likely there will be a “close match” in another book. If you switch tabs, SwordSearcher will usually just take you to the first entry.

Sometimes this might seem confusing, and you may wonder how to get back to what you were looking at before.

That’s easy. Just use the back button in the books panel. It remembers what you were viewing. It also has a long memory. Click the back button to go to your previous entry, or, right-click the back button to see a history of what you have viewed in the books panel, and you’ll get right back on track in no time.

The “Back” history menu in the Books panel.

The Bible and Commentary panels also have back/forward navigation buttons with history menus.