From CrossWire Bible Society
Revision as of 14:35, 15 October 2009 by David Haslam (talk | contribs) (Installation notes: your)

Jump to: navigation, search

MacSword is an open source Study Bible software that uses The SWORD Project. It was made for Mac OS X.

Anyone willing to provide screenshots should do so below, or edit this further.


  • Supports multiple bible versions
  • Parallel view (up to five versions)
  • Commentaries, Dictionaries, General Books
  • Footnotes, Text notes, Cross References
  • Strongs Hebrew/Greek numbers
  • Morphological Analysis codes
  • Headings and other text formatting (Words of Christ in red)
  • Search function
  • Non-Latin script (Hebrew, Greek, etc)
  • Different Bible translations
  • Commentaries
  • Dictionaries
  • Development is ongoing on both SWORD libs and MacSword, so check back every so often.

Installation notes

MacSword downloads from SourceForge for version 1.3.1b1 and above (see links below) is the application only. You can drop the application (once unzipped) anywhere on your hard disk.

Module installation

Manually installing modules

The download of MacSword application does not include any modules (bibles, dictionaries, etc.). You need to download them manually from the Crosswire website. For MacSword special modules (.swd) are available which have to be placed into the folder (if the folder does not exist, please create it first):

/Users/<username>/Library/Application Support/Sword

In MacSword under Preferences->Module you need to point the Modules location folder to be the folder mentioned above and then restart. For MacSword version 1.3.1b2 and above this location is preset and it does not need to be changed. Just place your downloaded modules in the above mentioned folder.

MacSword 2 does not have this setting in preferences. This path is the only pre-defined module path in MacSword 2.

Using the automatic module installer

Since MacSword version 1.4 a remote module installer is available for your convenience. It is accessible right below the "Preferences" menu item in the main menu bar of the application. The principal workflow is that you have at least one "install source" which are displayed on the left side. Each install source can have available modules which can be installed. On the first start of MacSword the default install source ("CrossWire") is automatically created for you. However you still need to refresh the install source.

Refreshing install sources: After Install sources have been created or added they need to be refreshed first. The refresh action downloads available module descriptions onto your hard disk. Also, if you want to update the install source to recognise updated modules, refresh it. After it has been refreshed and you click on it, all available modules are displayed in the table view on the right.

Marking modules for installation: Search the module(s) you want to install and select the "Install" task in the "Task" column of the table. The "Task" column rows contain a popup menu which shows available tasks for the chosen module. Alternatively do right-click the module and select "Install". If you made your selection, choose "Process Tasks" from the toolbar. This will download and install your selected modules.

Marking modules for removal: Modules that are install and have the "Installed" status can be removed. This works similar as for installing modules, you just use the "Remove" task. After you marked all modules for removal, choose "Process Tasks" from the toolbar.

Creating/Editing Personal Commentary modules

Both MacSword 1.4 and MacSword 2 support creating new personal commentary modules and editing them.

Creating personal commentary modules

MacSword 1 series:

In the main menu choose File->"New Module". This will open a file panel. The preset path where the new module is stored should be: "/Users/<yourlogin>/Library/Application Support/Sword". If that's not the case, navigate to this folder. Then just enter a module name in the top text field and press Ok.

The name should if possible not contain special characters and no spaces. Instead of spaces use underscore "_" or use a camel case naming scheme like "MyPersComment".

MacSword 2 series:

In the main menu choose File->"Create Module"->"Personal Commentary". You are then asked for a module name (please see the naming scheme above).

Editing personal commentary modules

MacSword 1 series:

Open the personal commentary module. Navigate to a Bible chapter/Verse you want to comment. To start editing choose Edit->"Edit module" from the main menu. Enter your comments and choose Edit->"Edit module" again to end the editing. Your comment should now be saved.

MacSword 2 series:

Open your personal commentary module. Navigate to a Bible chapter/verse. Press the "Edit" field which is on top of you text view next to the "+" and "x" fields. When in editing mode the "Edit" field should be in red color. Now enter you text between the verses. So store your text press the red "Edit" button again.

MacSword files and folders

MacSword creates and uses certain files and folders on your hard drive.

SWORD related files

Are stored under ~/Library/Application Support/Sword (where "~" is your home folder). These are mostly modules either manually copied there or downloaded using the module installer.

MacSword files

Are stored and created under ~/Library/Application Support/MacSword. Those files are:

  • Module index files. MacSword 1.4 and below store the module index files in folders directly under "MacSword" for example: "Index-KJV". MacSword 2.0 and above store all index files in a separate folder "Index".

Index files can easily be deleted. They are then simply re-created from within MacSword.

  • Dictionary module caches: cache-<modulename>. Those file also can be deleted without problems. They are used to speedup the dictionary lookup and are re-created if they don't exist.
  • Bookmarks are stored in a file: Bookmarklist.plist for MacSword >= 2.0 and Bookmarks.plist for MacSword <= 1.4.

These files shouldn't be deleted otherwise you will loose your bookmarks.

  • MacSword 2 default session file is: DefaultSession.plist". This file stores you last opened session which includes open windows, positions, open modules and such...
  • MacSword 2 also stores a file called: DefaultSearchBookSets.plist. In this file custom, user defined search book sets for indexed search are stored.


Are stored under ~/Library/Preferences:

  • "MacSword.plist" for MacSword < 2.0
  • "org.crosswire.MacSword.plist" for MacSword >= 2.0

Module creator/developer support

MacSword 2.0.0 now bundles universal binaries of the SWORD module command line tools. Those tools can be found in the Application bundle under "Contents/Resources/bin".

External links