open bookmarks and queries from the command line
|LTS Haskell 20.23:||0.1.1.0|
|Stackage Nightly 2023-05-31:||0.2.0.0|
|Latest on Hackage:||0.2.0.0|
Module documentation for 0.2.0.0
bm is a utility for opening bookmarks and queries from the command line.
The bookmarks and queries are configured hierarchically in YAML, and they are
referenced using keyword prefixes. It allows you to quickly open bookmarks
and perform search queries in your browser using only your keyboard.
bm is designed to work on any operating system, but it has only been tested
.deb Package Installation
Check the Releases page for
.rpm Package Installation
Check the Releases page for
Installation From Hackage
bm from Hackage using Cabal as follows:
$ cabal v2-install bm
Installation From Stackage
bm from Stackage using Stack as follows:
$ stack install bm
Bookmarks and search queries are configured using a hierarchy of keywords in a
YAML configuration file. They are selected using keyword prefixes as
command-line arguments. Command-line completion is available for Bash. See
bm man page for details.
Note that the command used to open bookmarks and queries can be customized in the configuration file. Specifying the command for your specific browser can make links open considerably faster than with the default (generic) command.
An example configuration file is available in the
config directory on
GitHub (example for the latest release: bm.yaml). The following are
example commands using this configuration file.
Open a bookmark link by specifying keywords. The Nix homepage can be opened with the following command:
$ bm nix
nixpkgs manual can be opened using the following command:
$ bm nix pkgs manual
Keyword prefixes can also be used. The following command also opens the
$ bm n p m
When more than one keyword has the same prefix, the first is selected. If a selected bookmark does not specify a URL, the first child is processed.
/ keyword defines a bookmark with a URL as well as a query. When no
query is specified, the URL is opened, allowing you to search with suggestions
using the search field. Open a query by specifying keywords followed by the
$ bm / LinearTypes
When multiple query arguments are provided, they are joined with a space.
- Hackage: https://hackage.haskell.org/package/bm
- Stackage: https://www.stackage.org/package/bm
- Flora: https://flora.pm/packages/@hackage/bm
- GitHub: https://github.com/ExtremaIS/bm-haskell
- GitHub Actions CI: https://github.com/ExtremaIS/bm-haskell/actions
main branch is reserved for releases. It may be considered stable, and
HEAD is always the latest release.
develop branch is the primary development branch. It contains changes
that have not yet been released, and it is not necessarily stable.
Hackage revisions are made for metadata changes, such as relaxation of
constraints when new versions of dependencies are released. The
metadata in the
main branch may therefore not match that of Hackage. The
bm.cabal metadata in the
develop branch may match, unless work is being
done on a new release that contains other changes.
All releases are tagged in the
main branch. Release tags are signed using
email@example.com GPG key.
Issues and feature requests are tracked on GitHub: https://github.com/ExtremaIS/bm-haskell/issues
Issues may also be submitted via email to firstname.lastname@example.org.
This project is released under the MIT License as specified in the
This project follows the Haskell package versioning policy, with
A may be incremented arbitrarily for
non-technical reasons, but semantic versioning is otherwise
A.B is the major version,
C is the minor version, and
is the patch version. Initial development uses versions
0.0.0.D, for which
every version is considered breaking.
The format of this changelog is based on Keep a Changelog, with the following conventions:
- Level-two heading
Unreleasedis used to track changes that have not been released.
- Other level-two headings specify the release in
A.B.C.D (YYYY-MM-DD)format, with newer versions above older versions.
- Level-three headings are used to categorize changes as follows:
- Changes are listed in arbitrary order and present tense.
- Add support for
ansi-wl-pprintdependency version upper bound
aesondependency version upper bound
transformersdependency version upper bound
vectordependency version upper bound
- Adjust dependency constraints to match tested versions
textdependency version upper bound
optparse-applicativedependency version upper bound
- Add dependency bounds
- Initial release