Home | Parent | ← Go → | Prior | Next

# 4.14 Bookmarkshelf Document File

Smarky, Synkmark, Markster and BookMacster are all document-based Macintosh apps. Your bookmarks and some settings are stored in the Bookmarkshelf Document (.bkmslf) file, which contains bookmarks and folders (your content). A Bookmarkshelf document can be Opened, Saved, backed-up, Saved As, Duplicated, or even Trashed or Deleted. All apps have adopted Apple’s auto save.

The Bookmarkshelf document, however, varies from documents in other apps in these ways:

- In Smarky, Synkmark, Markster, you have only one Bookmarkshelf document. It is opened (if necessary, created) for you automatically when you launch the app, and when you close the document, the app quits.

- Bookmarkshelf Documents have associated behaviors which which you control with Local Settings. With local settings, you can tell the app to do certain things when you launch BookMacster or open the document, and keep web browser bookmarks in sync with the document, and with each other.

## 4.14.1 Multiple Bookmarkshelf Document files

Most users want all of their bookmarks in one place, and if this applies to you, you should create only one Bookmarkshelf in BookMacster (or use Smarky, Synkmark or Markster which support only one). This single Bookmarkshelf can be set (and is so set, by default), to be opened whenever you launch BookMacster.

After OKing our warning, though, you can create multiple Bookmarkshelf Documents if you want to. Some good reasons for multiple Bookmarkshelf documents are:

- You prefer to keep a different bookmarks set in each client browser.
- You want to create a sub-set of your bookmarks for an associate.
- You prefer to strictly compartmentalize Work, Home Hobbies, etc.

If you think that you created multiple Bookmarkshelf document files inadvertently, and want to combine them, you should be aware of the following features in BookMacster and Mac OS X.

- In the main menu, File > Open Recent > will show all of the documents you’ve ever created that still exist, unless you have a large number.

- Mac OS X makes it easy to find where the current document is located in your file hierarchy.

- A quick way to find and trash any and all documents is to Reset and Start Over.

- The menu item: BookMacster > Stop all Syncing now will show documents that currently have syncing agents active, if any. The first number after this menu item title indiicates how many Workers are currently active, doing work. The second number, after the slash, indicates how many active agents are waiting for triggers such as bookmarks changes. “0” means that there are none.

- The magnifying glass in the upper right corner of your screen is the Spotlight feature of Mac OS X. To find all Bookmarkshelf documents, click Spotlight and enter .bkmslf. A list will appear. To open one of them, click it. If you have Mac OS X 10.9 or later, to simply show where it is in the filesystem without opening it, mouse over it until the popover appears showing info, and then hold down the command (⌘) key on your keyboard. The file path will appear at the bottom of the popover.

## 4.14.2 Automatic Saving

Since you may be adding bookmarks sporadically throughout the day, the Bookmarkshelf landing such bookmarks needs to be saved periodically.

When a bookmark is landed, the landing Bookmarkshelf is automatically saved, immediately. In addition, if the Inspector pops up, and if you make your changes and close the Inspector within 60 seconds, your changes are automatically saved when you close the Inspector.

If you are using Mac OS X 10.7 or later, these saves are coordinated with the Auto Save and Versions feature of Mac OS X.

If you are using BookMacster, you can switch off Auto Save by switching ON the checkbox at the bottom of Preferences > General. But we don’t recommend this. With Auto Save and Versions, you’ll never “lose” a bookmark.

## 4.14.3 Weird File Names

From time to time you may see copies of your Bookmarkshelf document (.bkmslf) files that have weird file names alongside the current version. These are usually nothing to worry about and, if all appears well with the current version, may be deleted. This section gives more detail.

### Filenames with Tildes (~)

If one day you see a mysterious extra Bookmarkshelf file with one or more tildes (~) between the filename and “.bkmslf”, and BookMacster is working fine for you, you may trash these tilde files. They were created by previous versions of BookMacster and are no longer readable. For more info, read on…

### Filenames with Sharp/Hash/Pound Characters (#)

If one day you see a mysterious extra Bookmarkshelf file with one or more # characters between the filename and “.bkmslf”, and BookMacster is working fine for you, you may trash such these # files.

When BookMacster opens a bookmarkshelf file, therefore, it examines the file for corruptions which it can fix. If any are found, BookMacster moves the corrupt document to a different name, fixes the corruptions, and saves the file. The old, corrupt file now has one or more # characters added between the filename and “.bkmslf”. If it turns out that the removed items are of value to you, our Support team may be able to recover the removed items from a # file.

### Filenames with (deleted xxxxxx)

Bookmarkshelf files which have been in your Dropbox folder may have been deleted by Dropbox.

## 4.14.4 Details of Bookmarkshelf Versioning

A Bookmarkshelf file, such as myname-01.bkmslf is actually a little database, with tables defined by the application version which created it. As Smarky, Synkmark, Markster and BookMacster are updated to new versions, sometimes news “rows”, “columns” or “tables” may be added to support new features. When a newer version of the app with such table changes opens a Bookmarkshelf which was created by an older version, it immediately renames the Bookmarkshelf file by apending a tilde (~) to its name, and then converts the file to the new table and saves it with the old name. It’s a built-in “feature” of Apple’s Core Data framework which is used by the app. The reason is that, on the rare occasion that the new version of the app doesn’t work for you, and you downgrade back to the older version, you won’t be able to open the new file, but will still be able to open the old tilde file.

Home | Parent | ← Go → | Prior | Next