URLSCAN(1)                  General Commands Manual                 URLSCAN(1)




<?><?><?> (NAME)
       urlscan - <?><?><?><?> URL<?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       urlscan [options] < message

       urlscan [options] message


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> urlscan <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> URL<?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?> URL <?><?>
       <?><?><?><?><?> webbrowser <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> BROWSER <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?><?><?> urlscan <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> mutt (1) <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> urlscan <?><?><?><?> <?><?> urlview(1) <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?>:

       1. <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> quoted-printable <?>
       base64.

       2. <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       (context) <?><?><?><?><?><?><?> <?><?> URL. <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> c.
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> URL<?><?>
       <?><?> <?><?><?><?> R.

       3. <?><?><?><?><?><?> URL <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> (primary selection) <?><?> <?><?><?><?> P <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> C.

       4. <?><?><?><?><?><?><?> (URL<?><?>) <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       URL<?><?> <?><?> <?><?><?><?><?><?><?> s <?><?> S.

       5. <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> /. <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?> / <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       6. <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (<?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>) <?><?> <?><?><?><?><?><?><?> <?><?> p.
       <?><?><?><?><?> urlscan -g <?><?> <?><?><?><?>
       ~/.config/urlscan/config.json <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>:

       http://urwid.org/manual/displayattributes.html#display-attributes

       <?><?><?> <?><?><?><?><?> <?><?> <?><?> `--width` <?><?><?><?><?>
       <?><?><?><?>.

       7. <?><?><?><?> u <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> (unescape) <?><?> <?><?> URL
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

       8. <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> URL <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> (pipe) <?><?><?><?> URL
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> --run-
       safe<?> --run <?> --pipe.

       9. <?><?><?><?><?><?><?> <?><?> l <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       URL<?><?> <?><?> <?><?><?><?> <?><?><?><?><?> webbrowser
       <?><?><?><?><?><?> (<?><?><?><?><?><?><?>)<?> xdg-open (<?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?>) <?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> --run-safe <?><?> --run
       <?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?><?><?> --run <?> --run-
       safe <?><?><?><?><?> --pipe <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?>.

       10. <?><?><?><?> F1 <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       11. <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> URL<?><?>. <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> --headers <?><?><?><?><?><?><?><?><?>
       Link<?> Archived-At <?> List-* <?><?><?><?> <?><?><?><?><?><?><?>.

       12. <?><?><?><?> <?><?><?><?> <?><?><?><?><?> URL <?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> a <?> o.


<?><?><?><?><?><?><?><?> (OPTIONS)
       -c, --compact
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> (context) <?><?><?><?><?><?><?> <?><?> URL
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       -d, --dedupe
              <?><?><?> URL<?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              URL<?><?>.

       -E, --regex <expression>
              <?><?><?><?><?><?><?> <?><?> <expression> <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> (regular
              expressions)<?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>.
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> 'mailto:' <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> urlscan <?><?> <?><?><?><?><?> URL <?><?><?><?><?>
              <?><?><?> (<?><?><?><?><?> '<filename>.<extension>') <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?>:

                  $ urlscan --regex 'https?://.+.216

       -f, --run-safe <expression>
              <?><?><?><?><?> <expression> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?> URL <?><?> <?><?><?><?><?><?>. <?><?> {} <?><?>
              <expression> <?><?><?><?> <?><?><?><?><?><?><?><?> URL
              <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?>:

                  $ urlscan --run-safe 'tmux set buffer {}'

       -g, --genconf
              <?><?><?><?><?> ~/.config/urlscan/config.json <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       -H, --nohelp
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --headers
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> URL<?><?>. <?><?> <?><?><?>
              <?><?><?><?> Link<?> Archived-At <?> List-* <?><?><?><?>
              <?><?><?><?><?><?><?>.

       -n, --no-browser
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              (<?><?><?><?><?> --compact <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>).

       -p, --pipe
              <?><?><?><?><?> (pipe) <?><?><?><?> URL <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> `--run-safe`
              <?><?> `--run` <?><?><?><?><?> <?><?><?> <?><?><?>. <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?> URL <?><?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?>:

                  $ urlscan --run-safe 'xclip -i' --pipe file.txt

       -R, --reverse
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              URL<?><?>.

       -r, --run <expression>
              <?><?><?><?><?> <expression> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?> URL <?><?> <?><?><?><?><?><?>. <?><?> {} <?><?>
              <expression> <?><?><?><?> <?><?><?><?><?><?><?><?> URL
              <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> | <?> > <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?><?><?><?>:

                  $ urlscan --run 'echo {} | xclip -i' file.txt

       -s, --single
              <?><?><?><?> <?><?> urlscan <?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

                  $ urlscan -s file.txt

       -w, --width
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       -W, --whitespace-off
              <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> (...) <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>.

       -C, --colors {true,256,88,16,8,mono}
              <?><?><?><?><?> <?><?><?><?> <?><?><?> urwid.
              <?><?><?><?><?><?><?> "16" <?><?><?>. "true" <?><?><?><?><?>
              <?><?> 2**24 <?><?><?> <?> "mono" <?><?><?><?><?> <?><?> <?>
              <?><?><?> <?><?><?>.

       -V, --version
              <?><?><?> <?><?><?><?> urlscan.


<?><?><?><?><?><?><?><?><?><?><?><?> <?><?> MUTT (MUTT INTEGRATION)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> urlscan <?><?>
       mutt<?> <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?> ~/.muttrc
       <?><?><?><?> <?><?><?><?>:


       macro index,pager \cb "<pipe-message> urlscan<Enter>" "call urlscan to
       extract URLs out of a message"

       macro attach,compose \cb "<pipe-entry> urlscan<Enter>" "call urlscan to
       extract URLs out of a message"


       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> mutt<?> <?><?><?><?><?>
       Control-b <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> '|' <?><?> urlscan
       <?><?><?><?><?> (pipe) <?><?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> '-d' <?><?> '-c') <?><?><?><?>
       <?><?><?><?>.


<?><?><?><?><?><?><?> <?><?><?><?><?><?> (KEYBINDINGS)
       <?><?><?><?><?> urlscan -g <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       ~/.config/urlscan/config.json <?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> "" <?><?><?><?> <?><?><?><?>. <?><?><?><?>
       <?><?><?><?>: "P": ""

       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>:

       add_url -- <?><?><?><?><?><?> <?><?> URL <?><?> <?><?>
       (<?><?><?><?><?><?><?>: a)

       all_escape -- <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> (unescape) <?><?> <?><?><?>
       URL<?><?> (<?><?><?><?><?><?><?>: u)

       all_shorten -- <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> URL<?><?> (<?><?><?><?><?><?><?>: S)

       bottom -- <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?><?>: G)

       clear_screen -- <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       (<?><?><?><?><?><?><?>: Ctrl-l)

       clipboard -- <?><?><?><?><?><?> URL <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       xsel/xclip (<?><?><?><?><?><?><?>: C)

       clipboard_pri -- <?><?><?><?><?><?> URL <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> (primary selection) <?><?>
       <?><?><?><?><?><?><?> <?><?> xsel/xclip (<?><?><?><?><?><?><?>: P)

       context -- <?><?><?><?><?>/<?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>: c)

       del_url -- <?><?><?> URL <?><?> <?><?> (<?><?><?><?><?><?><?>: d)

       down -- <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       (<?><?><?><?><?><?><?>: j)

       help_menu -- <?><?><?><?><?>/<?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?><?>: F1)

       link_handler -- <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> (webbrowser<?> xdg-open <?><?>
       <?><?><?><?><?><?>) (<?><?><?><?><?><?><?>: l)

       next -- <?><?><?> <?><?> URL <?><?><?><?> (<?><?><?><?><?><?><?>: J)

       open_queue -- <?><?><?> <?><?><?><?> <?><?><?><?> URL<?><?><?>
       <?><?><?><?><?> <?><?> <?><?> (<?><?><?><?><?><?><?>: o)

       open_queue_win -- <?><?><?> <?><?><?><?> <?><?><?><?> URL<?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?><?><?><?>: O)

       open_url -- <?><?><?> <?><?><?><?> URL <?><?><?><?><?><?><?><?><?><?>
       (<?><?><?><?><?><?><?>: space <?><?> enter)

       palette -- <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>: p)

       previous -- <?><?><?> <?><?> URL <?><?><?><?> (<?><?><?><?><?><?><?>:
       K)

       quit -- <?><?><?><?> (<?><?><?><?><?><?><?>: q <?><?> Q)

       reverse -- <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       (<?><?><?><?><?><?><?>: R)

       shorten -- <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       URL <?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>: s)

       top -- <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?><?>: g)

       up -- <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       (<?><?><?><?><?><?><?>: k)


<?><?><?><?><?><?><?> (FILES)
       $HOME/.config/urlscan/config.json

       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       /usr/share/doc/urlscan/README, urlview(1), mutt(1)


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Daniel Burrows
       <dburrows@debian.org> <?> Scott Hansen <tech@firecat53.net>
       <?><?><?><?><?> <?><?><?> <?><?><?>.

                                16 August 2026                      URLSCAN(1)