1BUKU(1)                          User Commands                         BUKU(1)
2
3
4

NAME

6       buku - Bookmark manager like a text-based mini-web
7

SYNOPSIS

9       buku [OPTIONS] [KEYWORD [KEYWORD ...]]
10

DESCRIPTION

12       buku is a command-line utility to store, tag, search and organize book‐
13       marks.
14
15       Features
16
17         * Store bookmarks with auto-fetched title, tags and description
18         * Auto-import from Firefox, Google Chrome, Chromium and MS Edge
19         * Open bookmarks and search results in browser
20         * Shorten, expand URLs, browse cached page from Wayback Machine
21         * Text editor integration
22         * Lightweight, clean interface, custom colors
23         * Powerful search options (regex, substring...)
24         * Continuous search with on the fly mode switch
25         * Portable, merge-able database to sync between systems
26         * Import/export bookmarks from/to HTML, XBEL, Markdown or Orgfile
27         * Smart tag management using redirection (>>, >, <<)
28         * Multithreaded full DB refresh, manual encryption support
29         * Shell completion scripts, man page with handy examples
30

OPERATIONAL NOTES

32       1.  The database file is stored in:
33             - $XDG_DATA_HOME/buku/bookmarks.db, if XDG_DATA_HOME  is  defined
34           (first preference), or
35             -  $HOME/.local/share/buku/bookmarks.db, if HOME is defined (sec‐
36           ond preference), or
37             - %APPDATA%\buku\bookmarks.db, if you are on Windows, or
38             - the current directory.
39
40       2.  If the URL contains characters like ';', '&' or brackets  they  may
41           be  interpreted  specially  by  the shell. To avoid it, add the URL
42           within single or double quotes ('/").
43
44       3.  URLs are unique in DB. The same URL cannot be added twice.
45
46       4.  Bookmarks with immutable titles are listed with '(L)' after the ti‐
47           tle.
48
49       5.  Tags:
50             -  Comma  (',')  is  the  tag  delimiter in DB. A tag cannot have
51           comma(s) in it. Tags are filtered (for  unique  tags)  and  sorted.
52           Tags  are  stored  in  lower  case and can be replaced, appended or
53           deleted.
54             - Page keywords having a word to comma ratio > 3 are appended  to
55           description rather than tags.
56             - Parent folder (and subfolder) names are converted to all-lower‐
57           case tags during bookmarks HTML import.
58             - Releases prior to v2.7 support both capital and lower cases  in
59           tags.  From  v2.7 all tags are stored in lowercase. An undocumented
60           option --fixtags is introduced to modify the older  tags.  It  also
61           fixes  another  issue  where the same tag appears multiple times in
62           the tagset of a record. Run buku --fixtags once.
63             - Tags can be edited from the prompt very easily using '>>'  (ap‐
64           pend),  '>'  (overwrite)  and '<<' (remove) symbols. The LHS of the
65           operands denotes the indices and ranges of tags to apply (as listed
66           by  --tag  or  key 't' at prompt) and the RHS denotes the actual DB
67           indices and ranges of the bookmarks to apply the change to.
68
69       6.  Update operation:
70             - If --title, --tag or  --comment  is  passed  without  argument,
71           clear the corresponding field from DB.
72             -  If  --url is passed (and --title is omitted), update the title
73           from web using the URL. Description is  updated  (if  --comment  is
74           omitted). Tags remain untouched.
75             -  If  indices are passed without any other options (--url, --ti‐
76           tle, --tag, --comment and --immutable), read the URLs from  DB  and
77           update  titles,  description  and  append  tags from web. Bookmarks
78           marked immutable are skipped.
79             - Can update bookmarks matching a search, when combined with  any
80           of the search options and no arguments to update are passed.
81
82       7.  Delete operation:
83             -  When  a record is deleted, the last record is moved to the in‐
84           dex.
85             - Delete doesn't work with range and indices provided together as
86           arguments. It's an intentional decision to avoid extra sorting, in-
87           range checks and to keep the auto-DB compaction  functionality  in‐
88           tact. On the same lines, indices are deleted in descending order.
89             -  Can delete bookmarks matching a search, when combined with any
90           of the search options and no arguments to delete are passed.
91
92       8.  Search works in mysterious ways:
93             - Case-insensitive.
94             - Matches words in URL, title and tags.
95             - --sany : match any of the keywords in URL, title or  tags.  De‐
96           fault search option.
97             - --sall : match all the keywords in URL, title or tags.
98             - --deep : match substrings (`match` matches `rematched`) in URL,
99           title and tags.
100             - --sreg : match a regular expression (ignores --deep).
101             - --stag : search bookmarks by tags, or list all tags  alphabeti‐
102           cally  with usage count (if no arguments). Delimit the list of tags
103           in the query with `,` to search for bookmarks that match ANY of the
104           listed  tags.  Delimit  tags  with `+` to search for bookmarks that
105           match ALL of the listed tags. Note that `,` and `+` cannot be  used
106           together  in  the  same  search. Exclude bookmarks matching certain
107           tags from the results by using ` - ` followed  by  the  tags.  Note
108           that the ` - ` operator and the ` + ` delimiter must be space sepa‐
109           rated: ` - ` instead of `-` and ` + ` instead of `+`.  This  is  to
110           distinguish  them  from hyphenated tags (e.g., `some-tag-name`) and
111           tags with '+'s (e.g., `some+tag+name`).
112             - Search for keywords along with tag filtering is  possible.  Two
113           searches are issued (one for keywords and another for tags) and the
114           intersection of the 2 sets is returned as the resultset.
115             - Search results are indexed incrementally. This index is differ‐
116           ent  from actual database index of a bookmark record which is shown
117           within '[]' after the title.
118             - Results for any keyword matches are ordered by  the  number  of
119           keyword matches - results matching more keywords (match score) will
120           appear earlier in the list.  Results  having  the  same  number  of
121           matches  will  be ranked by their record DB index. If only one key‐
122           word is searched, results will be ordered by DB  index,  since  all
123           matching records will have the same match score.
124
125       9.  Import:
126             -  Auto-import looks in the default installation path and default
127           user profile.
128             - URLs starting with `place:`, `file://` and `apt:`  are  ignored
129           during import.
130             -  Parent folder (and subfolder) names are automatically imported
131           as tags if --tacit is used.
132             - Tags are merged even if bookmark URL  exists  when  --tacit  is
133           used.
134
135       10. Encryption is optional and manual. AES256 algorithm is used. To use
136           encryption, the database file should be unlocked (-k) before  using
137           buku  and  locked  (-l) afterwards. Between these 2 operations, the
138           database file lies unencrypted on the  disk,  and  NOT  in  memory.
139           Also, note that the database file is unencrypted on creation.
140
141       11. Editor support:
142             -  A  single bookmark can be edited before adding. The editor can
143           be set using the environment variable  *EDITOR*  or  by  explicitly
144           specifying  the  editor. The latter takes precedence. If -a is used
145           along with -w, the details are populated in the editor template.
146             - In case of edit and update (a single  bookmark),  the  existing
147           record details are fetched from DB and populated in the editor tem‐
148           plate. The environment variable EDITOR must be set.  Note  that  -u
149           works independently of -w.
150             - All lines beginning with "#" will be stripped. Then line 1 will
151           be treated as the URL, line 2 will be the title,  line  3  will  be
152           comma  separated  tags, and the rest of the lines will be parsed as
153           descriptions.
154
155       12. Proxy support: please refer to the ENVIRONMENT section.
156
157       13. Alternative DB file:
158             - The option --db (to specify an alternative database file  loca‐
159           tion) is app-only. Manual usage is prone to issues arising from hu‐
160           man error.
161             - Note that this option is useful if you want  to  store  the  db
162           file  in  cloud synced location. Another mechanism could be to have
163           the db file synced and create a symlink to it at the default  loca‐
164           tion.
165

GENERAL OPTIONS

167       -a --add URL [tag, ...]
168              Bookmark  URL  along  with  comma-separated tags. A tag can have
169              multiple words.
170
171       -u --update [...]
172              Update fields of the bookmarks at specified indices in DB. If no
173              arguments  are  specified,  all  titles and descriptions are re‐
174              freshed from the web. Tags remain untouched. Works  with  update
175              modifiers  for  the  fields url, title, tag and comment. If only
176              indices are passed without any edit options, titles and descrip‐
177              tions are fetched and updated (if not empty). Accepts hyphenated
178              ranges and space-separated indices. Updates search results  when
179              used with search options, if no arguments.
180
181       -w --write [editor|index]
182              Edit  a  bookmark in editor before adding it. To edit and update
183              an existing bookmark, the index should be passed. In  this  case
184              the  environment variable EDITOR must be set. The last record is
185              opened in EDITOR if index=-1.
186
187       -d --delete [...]
188              Delete bookmarks. Accepts space-separated list of indices  (e.g.
189              5  6  23  4 110 45) or a single hyphenated range (e.g. 100-200).
190              Note that range and list don't work together. Deletes search re‐
191              sults when combined with search options, if no arguments.
192
193       -v --version
194              Show program version and exit.
195
196       -h --help
197              Show program help and exit.
198

EDIT OPTIONS

200       --url [...]
201              Specify  the  URL, works with --update only. Fetches and updates
202              title if --title is not used.
203
204       --tag [+|-] [...]
205              Specify comma separated tags, works with --add, --update. Clears
206              the  tags,  if  no arguments passed. Appends or deletes tags, if
207              list of tags is preceded by '+' or '-' respectively.
208
209       --title [...]
210              Manually specify the title, works with --add, --update. Omits or
211              clears the title, if no arguments passed.
212
213       -c --comment [...]
214              Add  notes  or  description  of  the bookmark, works with --add,
215              --update. Clears the comment, if no arguments passed.
216
217       --immutable N
218              Set the title, description and tags of a bookmark immutable dur‐
219              ing  autorefresh.  Works  with --add, --update. N=1 sets the im‐
220              mutable flag, N=0 removes it. If omitted,  bookmarks  are  added
221              with N=0.
222

SEARCH OPTIONS

224       -s --sany keyword [...]
225              Search  bookmarks  with  ANY  of the keyword(s) in URL, title or
226              tags and show the results. Prompts to  enter  result  number  to
227              open  in  browser.  Note that the sequential result index is not
228              the DB index. The DB index is shown within '[]' after the title.
229              This is the default search option for positional arguments if no
230              other search option is specified.
231
232       -S --sall keyword [...]
233              Search  bookmarks  with  ALL  keywords in URL, title or tags and
234              show the results. Behaviour same as --sany.
235              Special keywords:
236              "blank": list entries with empty title/tag
237              "immutable": list entries with locked title
238              NOTE: To search the keywords, use --sany
239
240       --deep Search modifier to match substrings. Works with --sany, --sall.
241
242       -r --sreg expression
243              Scan for a regular expression match.
244
245       -t --stag [tag [,|+] ...] [- tag, ...]
246              Search bookmarks by tags.
247              Use ',' delimiter to find entries matching ANY of the tags
248              Use ' + ' delimiter to find entries matching ALL  of  the  tags.
249              (Note that the ' + ' delimiter must be space separated)
250              NOTE: Cannot combine ',' and '+' in the same search
251              Use  ' - ' to exclude bookmarks that match the tags that follow.
252              (Note that the '-' operator must be space separated).
253              List all tags alphabetically, if no arguments. The  usage  count
254              (number  of  bookmarks  having  the  tag)  is shown within first
255              brackets.
256
257       -x --exclude keyword [...]
258              Exclude bookmarks matching the specified  keywords.  Works  with
259              --sany, --sall, --sreg and --stag.
260

ENCRYPTION OPTIONS

262       -l --lock [N]
263              Encrypt  (lock)  the DB file with N (> 0, default 8) hash passes
264              to generate key.
265
266       -k --unlock [N]
267              Decrypt (unlock) the DB file with N (> 0, default 8) hash passes
268              to generate key.
269

POWER OPTIONS

271       --ai   Auto-import  bookmarks from Firefox, Google Chrome, Chromium and
272              Edge browsers.
273
274       -e --export file
275              Export bookmarks to Firefox bookmarks formatted HTML. Works with
276              all search options.
277              XBEL is used if file has extension '.xbel'.
278              Markdown  is  used if file has extension '.md'. Markdown format:
279              [title](url), 1 entry per line.
280              Orgfile is used if file has extension '.org' Orgfile  format:  *
281              [[url][title]], 1 entry per line.
282              A buku database is generated if file has extension '.db'.
283
284       -i --import file
285              Import bookmarks from Firefox bookmarks formatted HTML.  file is
286              considered Firefox-exported JSON if it  has  '.json'  extension,
287              XBEL if it is '.xbel', Markdown (compliant with --export format)
288              if it is '.md', Orgfile if the extension is  '.org'  or  another
289              buku database if the extension is '.db'.
290
291       -p --print [...]
292              Show  details  (DB index, URL, title, tags and comment) of book‐
293              mark record by DB index. If no arguments, all records  with  ac‐
294              tual  index  from  DB  are  shown. Accepts hyphenated ranges and
295              space-separated indices. A negative value (introduced for conve‐
296              nience)  behaves  like  the tail utility, e.g., -n shows the de‐
297              tails of the last n bookmarks.
298
299       -f --format N
300              Show selective monochrome output  with  specific  fields.  Works
301              with  --print.  Search results honour the option when used along
302              with --json. Useful for creating batch scripts.
303              N = 1, show only URL.
304              N = 2, show URL and tags in a single line.
305              N = 3, show only title.
306              N = 4, show URL, title and tags in a single line.
307              N = 5, show title and tags in a single line.
308              To omit DB index from printed results, use N0, e.g., 10, 20, 30,
309              40, 50.
310
311       -j --json
312              Output  data  formatted  as  JSON, works with --print output and
313              search results.
314
315       --colors COLORS
316              Set output colors. Refer to the COLORS  section  below  for  de‐
317              tails.
318
319       --nc   Disable  color output in all messages. Useful on terminals which
320              can't handle ANSI color codes or scripted environments.
321
322       -n --count N
323              Number of results to show per page (default 10).
324
325       --np   Do not show the prompt, run and exit.
326
327       -o --open [...]
328              Open bookmarks by DB indices or ranges in browser. Open a random
329              index if argument is omitted.
330
331       --oa   Open  all  search results immediately in the browser. Works best
332              with --np. When used along with --update or --delete,  URLs  are
333              opened in the browser first and then modified or deleted.
334
335       --replace old new
336              Replace  old tag with new tag if both are passed; delete old tag
337              if new tag is not specified.
338
339       --shorten index|URL
340              Shorten the URL at DB index or  an  independent  URL  using  the
341              tny.im URL shortener service.
342
343       --expand index|URL
344              Expand the URL at DB index or an independent URL shortened using
345              tny.im.
346
347       --cached index|URL
348              Browse the latest cached version of the URL at DB  index  or  an
349              independent  URL  using  the Wayback Machine. Useful for viewing
350              the content of bookmarks which are not live any more.
351
352       --suggest
353              Show a list of similar tags to choose from  when  adding  a  new
354              bookmark.
355
356       --tacit
357              Show  lesser output. Reduces the verbosity of certain operations
358              like add, update etc.
359
360       --nostdin
361              Do not attempt to read data from standard input  e.g.  when  the
362              program is not executed from a tty.
363
364       --threads
365              Maximum  number  of  parallel  network connection threads to use
366              during full DB refresh. By default 4 connections are spawned.  N
367              can range from 1 to 10.
368
369       -V     Check  the latest upstream version available. This is FYI. It is
370              possible the latest  upstream  released  version  is  still  not
371              available in your package manager as the process takes a while.
372
373       -g --debug
374              Show debug information and additional logs.
375

PROMPT KEYS

377       1-N    Browse search results by indices and ranges.
378
379       O [id|range [...]]
380              Try to open search results or indices (when not in a search con‐
381              text) in a GUI browser. Toggle try to open urls in a  GUI  based
382              browser  (even  if  BROWSER is set) if no arguments. Toggling is
383              useful when trying to open bookmarks by DB index.
384
385       a      Open all search results in browser.
386
387       s keyword [...]
388              Search for records with ANY keyword.
389
390       S keyword [...]
391              Search for records with ALL keywords.
392
393       d      Toggle deep search to match substrings ('pen' matches 'opened').
394
395       r expression
396              Run a regular expression search.
397
398       t [...]
399              Search bookmarks by a tag. List all tags alphabetically,  if  no
400              arguments.
401
402       g taglist id|range [...] [>>|>|<<] [record id|range ...]
403              Append,  set,  remove  specific  or  all  tags by indices and/or
404              ranges to bookmark indices and/or ranges (see  EXAMPLES  section
405              below).  Search by space-separated taglist id(s) and/or range if
406              records are omitted.
407
408       o id|range [...]
409              Browse bookmarks by indices and/or ranges.
410
411       p id|range [...]
412              Print bookmarks by indices and/or ranges.
413
414       w [editor|id]
415              Edit and add or update a bookmark.
416
417       c id   Copy url at search result index to clipboard.
418
419       ?      Show help on prompt keys.
420
421       q, ^D, double Enter
422              Exit buku.
423

ENVIRONMENT

425       Completion scripts
426              Shell completion scripts for Bash, Fish and Zsh can be found in:
427              https://github.com/jarun/buku/blob/master/auto-completion
428
429       BROWSER
430              Overrides the default browser. Refer to:
431              http://docs.python.org/library/webbrowser.html
432
433       EDITOR If defined, will be used as the editor to  edit  bookmarks  with
434              option --write.
435
436       https_proxy
437              If  defined,  will  be  used  to access http and https resources
438              through the configured proxy. Supported format:
439              http[s]://[username:password@]proxyhost:proxyport/
440
441       GUI integration
442              buku can be integrated in a GUI environment with simple  tweaks.
443              Please refer to:
444              https://github.com/jarun/buku/wiki/System-integration
445

COLORS

447       buku allows you to customize the color scheme via a five-letter string,
448       reminiscent of BSD LSCOLORS. The five letters represent the colors of
449
450       - index
451       - title
452       - URL
453       - description/comment/note
454       - tag
455
456       respectively. The five-letter string is passed is as  the  argument  to
457       the  --colors  option,  or  as  the  value  of the environment variable
458       BUKU_COLORS.
459
460       We offer the following colors/styles:
461
462         ┌───────┬───────────────────────────────────────────────────┐
463         │Letter │ Color/Style                                       │
464         ├───────├───────────────────────────────────────────────────┤
465         │a      │ black                                             │
466         │b      │ red                                               │
467         │c      │ green                                             │
468         │d      │ yellow                                            │
469         │e      │ blue                                              │
470         │f      │ magenta                                           │
471         │g      │ cyan                                              │
472         │h      │ white                                             │
473         │i      │ bright black                                      │
474         │j      │ bright red                                        │
475         │k      │ bright green                                      │
476         │l      │ bright yellow                                     │
477         │m      │ bright blue                                       │
478         │n      │ bright magenta                                    │
479         │o      │ bright cyan                                       │
480         │p      │ bright white                                      │
481         │A-H    │ bold version of the lowercase-letter color        │
482         │I-P    │ bold version of the lowercase-letter bright color │
483         │x      │ normal                                            │
484         │X      │ bold                                              │
485         │y      │ reverse video                                     │
486         │Y      │ bold reverse video                                │
487         └───────┴───────────────────────────────────────────────────┘
488
489       The default colors string is oKlxm, which stands for
490
491       - bright cyan index
492       - bold bright green title
493       - bright yellow URL
494       - normal description
495       - bright blue tag
496
497       Note that
498
499       - Bright colors (implemented as \x1b[90m - \x1b[97m) may not be  avail‐
500         able in all color-capable terminal emulators;
501
502       - Some terminal emulators draw bold text in bright colors instead;
503
504       - Some terminal emulators only distinguish between bold and bright col‐
505         ors via a default-off switch.
506
507       Please consult  the  manual  of  your  terminal  emulator  as  well  as
508       https://en.wikipedia.org/wiki/ANSI_escape_code for details.
509
510

EXAMPLES

512       1.  Edit and add a bookmark from editor:
513
514              buku -w
515              buku -w 'gedit -w'
516              buku -w 'macvim -f' -a https://ddg.gg search engine, privacy
517
518           The  first  command picks editor from the environment variable EDI‐
519           TOR. The second command opens gedit in  blocking  mode.  The  third
520           command  opens macvim with option -f and the URL and tags populated
521           in template.
522
523       2.  Add a bookmark with tags 'search  engine'  and  'privacy',  comment
524           'Search engine with perks', fetch page title from the web:
525
526              buku -a https://ddg.gg search engine, privacy -c Search engine with perks
527
528           In the output, >: url, +: comment, #: tags.
529
530       3.  Add  a bookmark with tags 'search engine' & 'privacy' and immutable
531           custom title 'DDG':
532
533              buku -a https://ddg.gg search engine, privacy --title 'DDG' --immutable 1
534
535           Note that URL must precede tags.
536
537       4.  Add a bookmark without a title (works for update too):
538
539              buku -a https://ddg.gg search engine, privacy --title
540
541       5.  Edit and update a bookmark from editor:
542
543              buku -w 15012014
544
545           This will open the existing bookmark's details in  the  editor  for
546           modifications. Environment variable EDITOR must be set.
547
548       6.  Update  existing  bookmark at index 15012014 with new URL, tags and
549           comments, fetch title from the web:
550
551              buku -u 15012014 --url http://ddg.gg/ --tag web search, utilities -c Private search engine
552
553       7.  Fetch and update only title for bookmark at 15012014:
554
555              buku -u 15012014
556
557       8.  Update only comment for bookmark at 15012014:
558
559              buku -u 15012014 -c this is a new comment
560
561           Applies to --url, --title and --tag too.
562
563       9.  Export bookmarks tagged 'tag 1' or 'tag 2' to HTML, XBEL, Markdown,
564           Orgfile or a new database:
565
566              buku -e bookmarks.html --stag tag 1, tag 2
567              buku -e bookmarks.xbel --stag tag 1, tag 2
568              buku -e bookmarks.md --stag tag 1, tag 2
569              buku -e bookmarks.org --stag tag 1, tag 2
570              buku -e bookmarks.db --stag tag 1, tag 2
571
572           All bookmarks are exported if search is not opted.
573
574       10. Import bookmarks from HTML, XBEL, Markdown or Orgfile:
575
576              buku -i bookmarks.html
577              buku -i bookmarks.xbel
578              buku -i bookmarks.md
579              buku -i bookmarks.db
580
581       11. Delete only comment for bookmark at 15012014:
582
583              buku -u 15012014 -c
584
585           Applies  to  --title  and  --tag too. URL cannot be deleted without
586           deleting the bookmark.
587
588       12. Update or refresh full DB with page titles from the web:
589
590              buku -u
591              buku -u --tacit (show only failures and exceptions)
592
593           This operation can update the title or description fields  of  non-
594           immutable bookmarks by parsing the fetched page. Fields are updated
595           only if the fetched fields are non-empty. Tags remain untouched.
596
597       13. Delete bookmark at index 15012014:
598
599              buku -d 15012014
600
601           The last index is moved to the deleted index to keep  the  DB  com‐
602           pact. Add --tacit to delete without confirmation.
603
604       14. Delete all bookmarks:
605
606              buku -d
607
608       15. Delete a range or list of bookmarks:
609
610              buku -d 100-200
611              buku -d 100 15 200
612
613       16. Search  bookmarks  for ANY of the keywords 'kernel' and 'debugging'
614           in URL, title or tags:
615
616              buku kernel debugging
617              buku -s kernel debugging
618
619       17. Search bookmarks with ALL the keywords 'kernel' and 'debugging'  in
620           URL, title or tags:
621
622              buku -S kernel debugging
623
624       18. Search bookmarks tagged 'general kernel concepts':
625
626              buku --stag general kernel concepts
627
628       19. Search  for  bookmarks  matching  ANY of the tags 'kernel', 'debug‐
629           ging', 'general kernel concepts':
630
631              buku --stag kernel, debugging, general kernel concepts
632
633       20. Search for bookmarks matching ALL of  the  tags  'kernel',  'debug‐
634           ging', 'general kernel concepts':
635
636              buku --stag kernel + debugging + general kernel concepts
637
638       21. Search  for  bookmarks  matching  any  of  the  keywords 'hello' or
639           'world', excluding the keywords 'real' and  'life',  matching  both
640           the  tags 'kernel' and 'debugging', but excluding the tags 'general
641           kernel concepts' and 'books':
642
643              buku hello world --exclude real life --stag 'kernel + debugging - general kernel concepts, books'
644
645       22. List all unique tags alphabetically:
646
647              buku --stag
648
649       23. Run a search and update the results:
650
651              buku -s kernel debugging -u --tag + linux kernel
652
653       24. Run a search and delete the results:
654
655              buku -s kernel debugging -d
656
657       25. Encrypt or decrypt DB with custom number of iterations (15) to gen‐
658           erate key:
659
660              buku -l 15
661              buku -k 15
662
663           The  same number of iterations must be specified for one lock & un‐
664           lock instance. Default is 8, if omitted.
665
666       26. Show details of bookmarks  at  index  15012014  and  ranges  20-30,
667           40-50:
668
669              buku -p 20-30 15012014 40-50
670
671       27. Show details of the last 10 bookmarks:
672
673              buku -p -10
674
675       28. Show all bookmarks with real index from database:
676
677              buku -p
678              buku -p | more
679
680       29. Replace tag 'old tag' with 'new tag':
681
682              buku --replace 'old tag' 'new tag'
683
684       30. Delete tag 'old tag' from DB:
685
686              buku --replace 'old tag'
687
688       31. Append (or delete) tags 'tag 1', 'tag 2' to (or from) existing tags
689           of bookmark at index 15012014:
690
691              buku -u 15012014 --tag + tag 1, tag 2
692              buku -u 15012014 --tag - tag 1, tag 2
693
694       32. Open URL at index 15012014 in browser:
695
696              buku -o 15012014
697
698       33. List bookmarks with no title or tags for bookkeeping:
699
700              buku -S blank
701
702       34. List bookmarks with immutable title:
703
704              buku -S immutable
705
706       35. Shorten the URL www.google.com and the URL at index 20:
707
708              buku --shorten www.google.com
709              buku --shorten 20
710
711       36. Append, remove tags at prompt (taglist index to the left,  bookmark
712           index to the right):
713
714              // append tags at taglist indices 4 and 6-9 to existing tags in bookmarks at indices 5 and 2-3
715              buku (? for help) g 4 9-6 >> 5 3-2
716              // set tags at taglist indices 4 and 6-9 as tags in bookmarks at indices 5 and 2-3
717              buku (? for help) g 4 9-6 > 5 3-2
718              // remove all tags from bookmarks at indices 5 and 2-3
719              buku (? for help) g > 5 3-2
720              // remove tags at taglist indices 4 and 6-9 from tags in bookmarks at indices 5 and 2-3
721              buku (? for help) g 4 9-6 << 5 3-2
722
723       37. List bookmarks with colored output:
724
725              $ buku --colors oKlxm -p
726

AUTHOR

728       Arun Prakash Jana <engineerarun@gmail.com>
729

HOME

731       https://github.com/jarun/buku
732

WIKI

734       https://github.com/jarun/buku/wiki
735

REPORTING BUGS

737       https://github.com/jarun/buku/issues
738

LICENSE

740       Copyright © 2015-2022 Arun Prakash Jana <engineerarun@gmail.com>.
741
742       License   GPLv3+:  GNU  GPL  version  3  or  later  <http://gnu.org/li
743       censes/gpl.html>.
744       This is free software: you are free  to  change  and  redistribute  it.
745       There is NO WARRANTY, to the extent permitted by law.
746
747
748
749Version 4.7                       1 Jul 2022                           BUKU(1)
Impressum