{"id":16670066,"url":"https://github.com/liske/htmail-view","last_synced_at":"2025-04-09T19:41:11.380Z","repository":{"id":140083763,"uuid":"43174967","full_name":"liske/htmail-view","owner":"liske","description":"single web page renderer based on WebKit2","archived":false,"fork":false,"pushed_at":"2019-07-20T21:20:11.000Z","size":57,"stargazers_count":20,"open_issues_count":6,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-23T21:35:49.410Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liske.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-09-25T20:52:20.000Z","updated_at":"2022-02-22T03:40:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"414c6f07-03a2-4c65-877e-e85362adad1c","html_url":"https://github.com/liske/htmail-view","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liske%2Fhtmail-view","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liske%2Fhtmail-view/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liske%2Fhtmail-view/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liske%2Fhtmail-view/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liske","download_url":"https://codeload.github.com/liske/htmail-view/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248100396,"owners_count":21047786,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T11:36:54.652Z","updated_at":"2025-04-09T19:41:11.363Z","avatar_url":"https://github.com/liske.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"htmail-view\n===========\n\nAbout\n-----\n\nWeb page renderer based on WebKit2. In contrast to a ordenary WebKit2-based\nbrowser, *htmail-view* will prevent loading remote content while showing\na single web page (i.e. from a local file).\n\nIt was written to be called from *mutt* to view HTML mails. It tries to\nprotect the users privacy by not loading remote resources. The default\nbrowser will be used if the user follows a link.\n\n\nPrerequisites\n-------------\n\n- Gtk3 gir bindings\n- WebKit2 gir bindings\n- Perl packages\n  - Browser::Open\n  - Glib::Object::Introspection\n  - URI\n- wmctrl (optional; used by wmctrl-wrapper)\n\n\nInstallation\n------------\n\n*htmail-view* is a self-contained perl script. On *Debian GNU/Linux* you\ncould use the prepared **.deb** packages (see github releases).\n\n\nUsage\n-----\n\n\n### Mutt\n\n\n`~/.muttrc`\n```ini\n# prefer plain text\nalternative_order text/plain text/enriched text/html\n\n# auto convert text/html MIME type to text/plain\nauto_view text/html\n\n# run viewer defined in mailcap by \u003creturn\u003e in attach view\nbind attach \u003creturn\u003e view-mailcap\n\n# mailcap file to use (optional)\nset mailcap_path=\"~/.mutt/mailcap\"\n\n\n# handover mail to htmail-view (works only for multipart mails containing text/html payload)\nmacro index,pager H \"\u003cpipe-message\u003ehtmail-decode\u003creturn\u003e\" \"render html mail using htmail-view\"\n```\n\nThe Debian package will aready add an entry to the global mailcap file.\n\n\n#### Use htmail-view for text/html parts\n\n`mailcap`\n```bash\ntext/html; htmail-view file://%s; test=test -n \"$DISPLAY\"; nametemplate=%s.html; needsterminal;\ntext/html; w3m -I %{charset} -T text/html; copiousoutput;\n```\n\n\n#### Use wmctrl wrapper (focus handling)\n\nThe wrapper will save the window id of the currently focused window **before**\n*htmail-view* is launched. After *htmail-view* has been terminated it will try\nto restore the focused window.\n\n`mailcap`\n```bash\ntext/html; /usr/lib/htmail-view/wmctrl-wrapper file://%s; test=test -n \"$DISPLAY\"; nametemplate=%s.html; needsterminal;\ntext/html; w3m -I %{charset} -T text/html; copiousoutput;\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliske%2Fhtmail-view","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliske%2Fhtmail-view","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliske%2Fhtmail-view/lists"}