# Bookmarking using spmenu_run

spmenu_run provides bookmarking entries or just general text if preferred.

## Usage

To view the saved bookmarks, open `spmenu_run -x` (the run launcher component) and
type in `@`. If you have no bookmarks what you're going to get is an empty menu.
To add bookmarks, type @ followed by a command. For example `@chromium` will
bookmark an entry called `chromium`, which will open Chromium.

## The : separator

If you want a longer command, you might want a shorter title to be displayed
. In that case you can type @ followed by a name and a colon.
Anything you type *after* the colon will be executed using a shell. For example
`@spmenu documentation:chromium https://spmenu.speedie.site` will add an entry called
`spmenu documentation` which when selected will open the spmenu wiki in Chromium.

For traditional bookmarking, consider something like
`@spmenu documentation:echo spmenu.speedie.site | xclip -sel clipboard`. spmenu_run
bookmarks should be treated as shell commands.

## Using a text editor

Entries can also be added using a text editor. By default the path to the bookmark
file is `~/.cache/spmenu_run.bookmarks`. This is a plain text file that can be edited
by hand. You can easily add entries here.