What do I need to run Webjimbo?

July 11th, 2011 by

Webjimbo runs a small web server that you connect to with a web browser. For this to work your Mac obviously needs to be visible on the internet. This means:

* Your Mac needs to be on the internet.
* You need to leave your Mac switched on, logged in and running Webjimbo. You also need to make sure it doesn’t go to sleep – see Energy Saver in the system preferences.
* You might need to configure your Mac’s firewall. The setup assistant in Webjimbo tells you how to do this.
* Your Mac needs to have an internet address. If you have a fixed IP address you can use that, otherwise you will probably need a dynamic DNS service like DynDNS or No-IP. If you don’t understand all this click here for more help.
* Depending on your network setup, you might need to configure your Airport base station or other router to allow connections from the outside world on the port you choose for Webjimbo. More about this…

Webjimbo installation and setup

* Installation: Webjimbo is a simple Mac application and you just need to drag it from the disk image to your applications folder.
* Setup: The easiest way to set up Webjimbo is to use the Setup Assistant. This runs automatically when you first launch the application, or you can run it anytime from the Help menu. For a more direct approach, click the Configure button or choose Preferences from the menu.

Yojimbo permissions for viewing passwords and encrypted notes

If you want to view passwords and encrypted notes in Webjimbo, you need to change Yojimbo’s security settings.

1. Open Yojimbo’s preferences, and click on the Security icon
2. Click the lock (bottom left) and enter your password to make changes
3. Check the last two boxes, labelled “Accessing password items from scripts” and “Accessing encrypted items from scripts”

You should be aware that by doing this you’re allowing any AppleScript running on your Mac to have access to your passwords and encrypted items.

Accessing Webjimbo from the internet

You will need to configure your Airport Base Station or router if you have one. Click here for instructions. To find out about your Mac’s address on the internet, click here.
* To use Webjimbo from the outside world, browse to https://(your address):(port), for example https://mymac.example.com:8888. If you have a fixed IP address, it will look more like https://10.11.12.13:8888.
* Don’t forget, if you’re not using a secure connection the URL starts with “http” not “https”.

Logging in

Use your Mac user name. This is the same as the name of your home folder. The password is the one you chose during setup, or specified in the preferences.
Changing when items are fetched
By default, when you select a collection Webjimbo fetches the collection’s items. This is good because it’s consistent with Yojimbo, but because fetching isn’t as quick it can be annoying when you just want to do a quick search.
You can change this by clicking the preferences icon (next to Help) in the web interface. You have three options; the second one tries to strike a balance between performance and ease of use.

Keyboard shortcuts

You can use the keyboard to perform a number of common operations. Keyboard shortcuts consist of some combination of the shift, control and alt keys, plus a letter. The default on the Mac is control, and on other operating systems it’s alt, but you can configure this to your liking in the preferences.

The shortcut keys are:
* K Moves the cursor to the search box.
* L Selects the Library and moves the cursor to the search box.
* S Saves the item you’re editing.
* N Creates a new note.
* B Creates a new bookmark.
* R Creates a new serial number.
* W Creates a new web archive.
* P Creates a new PDF archive.
* \ Moves the selected item to the trash or removes it from the collection.

Limitations

Webjimbo provides Yojimbo’s main operations, but doesn’t do everything. The main limitations are:

* Note editing is plain text only. You can view formatted notes (including attachments), but if you edit them formatting and attachments will be lost.
* Encrypted notes are displayed in plain text only, without formatting or attachments.
* You can’t edit passwords or encrypted notes.
* You can’t view encrypted archives.
* You can only select (and therefore search) one collection at a time. Similarly, you can only work with one item at a time.
* You can’t choose which columns to display.
* You can’t choose which collections to display