mbm/mbm.1 at main · devEducaua/mbm · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
.TH MBM 1 "April 2026" "mbm 1.0" "User Commands"

.SH NAME
mbm \- manage bookmarks from the command line

.SH SYNOPSIS
.B mbm
.RI [ COMMAND ] [ OPTIONS ]

.SH DESCRIPTION
mbm is a simple command-line bookmark manager.

.SH COMMANDS

.TP
.B list
list bookmarks.
.br
mbm list [--tags TAGS] [--file PATH] [--query QUERY] [--verbose]

.TP
.B get
get bookmark url.
.br
mbm get NAME [--file PATH]

.TP
.B open
open bookmark url in default application.
.br
mbm open NAME [--file PATH]

.TP
.B add
add a new bookmark
.br
mbm add URL [--name NAME] [--tags TAGS] [--file PATH]

.TP
.B import
import a list of bookmarks from file to config.
.br
mbm import --file PATH

.TP
.B copy
copy bookmark url to clipboard.
.br
mbm copy NAME [--file PATH]

.TP
.B edit
open bookmarks file in $EDITOR.
.br
mbm edit

.TP
.B help
opens this manpage.
.br
mbm help

.SH OPTIONS

.TP
.B --tags TAGS
filter bookmarks by a comma-separated list of tags.

.TP
.B --file PATH
use an alternative bookmark file.

.TP
.B --query QUERY
a query structured in reverse polish notion, wiki keywords: "and", "or" and "not".

.TP
.B --verbose
enable verbose output.

.TP
.B --name NAME
name of the bookmark.

.SH NOTES
.B copy
command on wayland depends on wl-clipboard and on x11 depends on xclip.

.SH EXAMPLES

.TP
list bookmarks with tags:
.B mbm list --tags personal,work

.TP
list bookmarks that have the tag programming but not the tag blog.
.B mbm list --query "programming blog not and"

.TP
add a bookmark:
.B mbm add https://example.com --name example --tags personal

.TP
get a bookmark:
.B mbm get example

.TP
open a bookmark:
.B mbm open example

.SH EXIT STATUS
0 on success, non-zero on error.

.SH FILES
.TP
.I ~/.config/mbm/config
default bookmark file.