LinuxCommandLibrary

eww

Create and manage custom desktop widgets

TLDR

Start the daemon

$ eww daemon
copy

Open a widget
$ eww [[-c|--config]] [path/to/source_code_directory] open [window_name]
copy

Close a widget
$ eww [[-c|--config]] [path/to/source_code_directory] close [window_name]
copy

Reload the configuration
$ eww reload
copy

Kill the daemon
$ eww kill
copy

Print and watch logs
$ eww logs
copy

SYNOPSIS

eww [URL]

PARAMETERS

URL
    The URL to open in EWW. If no URL is provided, EWW starts with a blank page.

-eval
    Evaluate an Emacs Lisp expression before displaying the URL.

-no-site-file
    Do not load the site-file.

-insert-directory
    Insert the current directory.

-insert-file
    Insert a file.

DESCRIPTION

eww is a general-purpose Emacs Web Wowser.
It is designed to be lightweight and display web content directly within the terminal. eww renders the content using libraries like libxml2 and displays it as formatted text. It is useful for quick lookups, reading documentation, or viewing simple web pages from the command line.
EWW aims to provide a functional browsing experience without the overhead of a graphical browser. It supports basic HTML rendering, links, and forms. It can also be integrated into other Emacs workflows for tasks like web scraping or automating web interactions. The quality of the rendering depends on the website but simple pages render reasonably well. It is typically run from within Emacs but can be launched independently. EWW also has built-in support for gnus newsgroups and it can view RFC formatted texts.

CAVEATS

eww is a terminal-based browser, so it does not support all web features, such as JavaScript or Flash. It may also render complex web pages poorly. The security of browsing with eww is limited.

CUSTOMIZATION

EWW's appearance and behavior can be extensively customized using Emacs Lisp. This includes setting custom fonts, colors, and keybindings. The user can also extend EWW's functionality by writing custom functions to handle specific types of web content.

SECURITY

eww may not support latest web technologies that provide security agains modern exploits. Be wary of entering any credentials.

HISTORY

EWW is a long-standing Emacs package, originally developed as a simple way to view web pages within Emacs. It has evolved over time to include more features, such as support for forms, cookies, and basic JavaScript. It remains a useful tool for developers and power users who want to integrate web browsing into their Emacs workflow.

SEE ALSO

curl(1), wget(1), lynx(1)

Copied to clipboard