meta: Add qutebrowser

This was my configuration for qutebrowser, a web browser that I
revisited in 2022 and decided to use for a few months. Although I
certainly found the experience quite cute, I came across issues such
as the content window blanking when switching workspaces, strict https
mode not being supported, containerization requiring separate tabs, and
frequent crashes when dealing with large amounts of tabs.

Besides the issues above, I also had to deal with certain websites
not loading in qutebrowser without any way to troubleshoot it from
developer tools. In addition to the lack of extension support (thereby
requiring more involved measures to replicate similar behavior found in
other browsers) and the inferior content blocking solution, I ultimately
decided to switch back to my old trusty friend firefox.

qutebrowser/.config/qutebrowser/config.py

@@ -0,0 +1,176 @@
+import pywalQute.draw
+import time
+
+# Don't use auto-saved settings
+config.load_autoconfig(False)
+
+# Mute tabs by default
+from qutebrowser.mainwindow import tabwidget
+tabwidget.TabWidget.MUTE_STRING = ""
+tabwidget.TabWidget.AUDIBLE_STRING = "[A]"
+
+# Make color scheme match pywal
+pywalQute.draw.color(c, {
+  'spacing': {
+    'vertical': 0,
+    'horizontal': 0
+  }
+})
+
+# Don't close while browsing / downloading
+c.confirm_quit = ['multiple-tabs', 'downloads']
+
+# Restore previous tabs
+c.session.lazy_restore = True
+
+# Use ranger as the file selector
+c.fileselect.handler = 'external'
+c.fileselect.folder.command = ['kitty', '-e', 'ranger', '--choosedir={}']
+c.fileselect.multiple_files.command = ['kitty', '-e', 'ranger', '--choosefiles={}']
+c.fileselect.single_file.command = ['kitty', '-e', 'ranger', '--choosefile={}']
+
+# Better context menu colors
+c.colors.contextmenu.disabled.fg = '#808080'
+c.colors.contextmenu.menu.bg = '#353535'
+c.colors.contextmenu.menu.fg = '#ffffff'
+c.colors.contextmenu.selected.bg = '#909090'
+
+# Use spellcheck
+c.spellcheck.languages = ["en-US"]
+
+# Chromium flags
+c.qt.args = ["disable-backing-store-limit", "enable-accelerated-video-decode", "disable-gpu-driver-bug-workarounds"]
+c.qt.chromium.low_end_device_mode = 'never'
+
+# Make new tab position more sane
+c.tabs.new_position.unrelated = 'next'
+
+# Download settings
+c.downloads.location.directory = "$HOME/Downloads"
+c.downloads.location.prompt = False
+c.downloads.position = "bottom"
+c.downloads.remove_finished = 5000
+
+# Only show tabs when multiple are open
+c.tabs.show = "multiple"
+
+# Don't switch tabs with mouse
+c.tabs.mousewheel_switching = False
+
+# Edit text with neovim
+c.editor.command = ['kitty', '-e', 'nvim', '{}']
+
+# Use J/K for prev/next
+config.bind('J', 'tab-prev')
+config.bind('K', 'tab-next')
+
+# Use F12 for devtools
+config.bind('<F12>', 'devtools')
+
+# Use zb to delete bookmarks
+config.bind('zb', 'bookmark-del')
+
+# Increase the default scroll offset of j/k
+# NOTE: Unfortunately this breaks websites that use their own keybinds for j/k/etc
+# config.bind('j', 'run-with-count 5 scroll down')
+# config.bind('k', 'run-with-count 5 scroll up')
+
+# NOTE: Use with smooth smooth scrolling enabled to scroll smoothly
+# config.bind('d', 'run-with-count 12 scroll down')
+# config.bind('u', 'run-with-count 12 scroll up')
+
+# Use d/u to scroll down/up
+config.bind('d', 'scroll-page 0 0.5')
+config.bind('u', 'scroll-page 0 -0.5')
+config.bind('D', 'scroll-page 0 0.5')
+config.bind('U', 'scroll-page 0 -0.5')
+
+# Use alt+left/right to go back/forward
+config.bind('<Alt+Left>', 'back')
+config.bind('<Alt+Right>', 'forward')
+
+# Use x to close tabs and X to undo
+config.bind('x', 'tab-close')
+config.bind('X', 'undo')
+
+# Toggle tab visibility for more screen space
+config.bind('st', 'config-cycle tabs.show multiple switching')
+
+# Easily change the position of tabs
+config.bind('sTh', 'set tabs.position left')
+config.bind('sTj', 'set tabs.position bottom')
+config.bind('sTk', 'set tabs.position top')
+config.bind('sTl', 'set tabs.position right')
+
+# Don't paste something by accident
+config.unbind('pp', mode='normal')
+config.unbind('pP', mode='normal')
+config.unbind('Pp', mode='normal')
+config.unbind('PP', mode='normal')
+config.unbind('wp', mode='normal')
+config.unbind('wP', mode='normal')
+
+# Easily enter account information
+# NOTE: I re-evaluated pass when I was focusing on a terminal-centric workflow.
+config.bind('zl', 'spawn --userscript qute-pass')
+config.bind('zpl', 'spawn --userscript qute-pass --password-only')
+config.bind('zol', 'spawn --userscript qute-pass --otp-only')
+
+# Support previous/next tab with traditional keybinds
+config.bind('<Ctrl+Shift+Tab>', 'tab-prev')
+config.bind('<Ctrl+Tab>', 'tab-next')
+
+# Hide the status bar except under exceptional circumstances
+# NOTE: This broke more things than not, which is why I ultimately decided
+#       to always use the status bar. More information can be found in the
+#       following discussion: https://github.com/qutebrowser/qutebrowser/issues/2236
+# config.bind('o', 'set statusbar.show always;; set-cmd-text -s :open')
+# config.bind('O', 'set statusbar.show always;; set-cmd-text -s :open -t')
+# config.bind('T', 'set statusbar.show always;; set-cmd-text -sr :tab-focus')
+# config.bind(':', 'set statusbar.show always;; set-cmd-text :')
+# config.bind('/', 'set statusbar.show always;; set-cmd-text /')
+# config.bind('<Escape>', 'mode-enter normal;; set statusbar.show in-mode', mode='command')
+# config.bind('<Return>', 'command-accept;; set statusbar.show in-mode', mode='command')
+
+# Easily start a new temporary container
+config.bind(';s', 'hint links spawn ~/.local/bin/tmp {hint-url}')
+
+# Open the current tab / selected link in mpv
+config.bind('zM', 'spawn mpv --force-window=immediate {url}')
+config.bind('zm', 'hint links spawn mpv --force-window=immediate {hint-url}')
+
+# Automatically mute tabs
+c.content.mute = True
+
+# Use proxy websites for popular services
+config.bind('zu', 'hint links spawn -u untrack-url -O {hint-url}')
+
+# Enable expected permissions to avoid websites asking every time
+c.content.persistent_storage = True
+c.content.notifications.enabled = True
+c.content.register_protocol_handler = True
+
+# Hide the window title bar on GNOME
+# NOTE: This is no longer necessary since GNOME has an extension called
+#       pixel-saver that # automatically handles this for us, and without
+#       the downsides of not having a window bar.
+# c.window.hide_decoration = True
+
+# Close qutebrowser when there are no tabs left
+c.tabs.last_close = "close"
+
+# Don't automatically enter/leave insert mode
+# NOTE: This was originally done to prevent insert mode from prematurely exiting
+#       in certain # cases (such as mouse usage), although keeping auto functionality
+#       seems to be more useful # long-term.
+c.input.insert_mode.auto_enter = False
+c.input.insert_mode.auto_leave = False
+
+# Prioritize Japanese content (en-US is necessary to avoid breaking things)
+c.content.headers.accept_language = 'ja-JP,en-US'
+
+# NOTE: Yomichan is still the most efficient pop-up dictionary; I only include
+#       this Yomichad implementation for historical purposes.
+for mode in ["normal", "caret"]:
+  config.bind('gs', 'spawn --userscript yomichad', mode=mode)
+  config.bind('gS', 'spawn --userscript yomichad --prefix-search', mode=mode)

qutebrowser/README.md

@@ -0,0 +1,15 @@
+# qutebrowser
+
+[qutebrowser][qutebrowser] is a vim-like web browser based on chromium.
+
+## Use Cases
+
+qutebrowser can be used to:
+
+- Browse the web with familiar vim-like keybindings
+
+You should not use qutebrowser if:
+
+- You want to take advantage of existing browser extensions
+
+[qutebrowser]: https://qutebrowser.org/