{"id":37191338,"url":"https://github.com/skx/webmail","last_synced_at":"2026-01-14T22:09:45.652Z","repository":{"id":56280001,"uuid":"141964234","full_name":"skx/webmail","owner":"skx","description":"A golang webmail server.","archived":true,"fork":false,"pushed_at":"2020-11-17T04:33:23.000Z","size":1423,"stargazers_count":52,"open_issues_count":3,"forks_count":26,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-09-20T00:29:31.937Z","etag":null,"topics":["golang","imap-client","webmail"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":false,"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/skx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-23T05:12:07.000Z","updated_at":"2024-05-30T01:22:16.000Z","dependencies_parsed_at":"2022-08-15T15:50:57.619Z","dependency_job_id":null,"html_url":"https://github.com/skx/webmail","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/skx/webmail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skx%2Fwebmail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skx%2Fwebmail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skx%2Fwebmail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skx%2Fwebmail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skx","download_url":"https://codeload.github.com/skx/webmail/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skx%2Fwebmail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28436268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T21:32:52.117Z","status":"ssl_error","status_checked_at":"2026-01-14T21:32:33.442Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["golang","imap-client","webmail"],"created_at":"2026-01-14T22:09:44.882Z","updated_at":"2026-01-14T22:09:45.630Z","avatar_url":"https://github.com/skx.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Go Report Card](https://goreportcard.com/badge/github.com/skx/webmail)](https://goreportcard.com/report/github.com/skx/webmail)\n[![license](https://img.shields.io/github/license/skx/webmail.svg)](https://github.com/skx/webmail/blob/master/LICENSE)\n[![Release](https://img.shields.io/github/release/skx/webmail.svg)](https://github.com/skx/webmail/releases/latest)\n\n# Webmail\n\nThis repository contains a simple webmail implementation for golang:\n\n* You can connect to a remote IMAP server and perform basic operations\n  * Retrieve the list of remote folders.\n  * Open a folder and see the appropriate messages.\n     * Unread messages will be displayed in bold.\n     * Messages which have been replied to will be shown with an icon.\n     * Messages with attachments will display a \"paperclip\" next to them.\n     * You can page back/forward by 50 messages.\n  * For any message in the folder list you can retrieve it\n     * Which will also mark the message as being read.\n     * The message will be displayed as (filtered) HTML, Plain text, and RAW as applicable.\n     * Attachments will be displayed and may be downloaded.\n\nThis application has been tested against three remote IMAP hosts:\n\n* GMail\n* GMX\n* My mailserver, running dovecot.\n\nAll perform well, though in all honesty my own server performs the worst\nbecause I have ~1000 mailboxes.  So just getting the folder list takes\nsome time I'd rather avoid.\n\n# Screenshots\n\nThere are a collection of screenshots here:\n\n* [SCREENSHOTS.md](SCREENSHOTS.md)\n\n## Installation\n\nTo install this run:\n\n     ~ $ go get -u github.com/skx/webmail\n     ~ $ go install github.com/skx/webmail\n\n## Usage\n\nBuild the application and start it:\n\n     ~$ webmail\n\nNow point your favourite browser at http://localhost:8080/ and fill in the appropriate details.  For example if you wished to test against Google-mail you'd enter the following values:\n\n\n| Value    | Setting                 |\n| -------- | ----------------------- |\n| Host     | imaps://imap.gmail.com/ |\n| Username | example@gmail.com       |\n| Password | s3cr1t                  |\n\n\n**NOTE**: If you want to us IMAP (143) use `imap://` as a prefix, if you want IMAPS (993) use `imaps://`.  To avoid issues I'm __NOT__ validating the SSL certificate.  This is intentional.  Sorry.\n\n\n\n## Limitations\n\nThe main limitation is that this is a naive webmail client, which means that\nevery time you carry out an option the flow goes:\n\n* Your browser sends a request to this server.\n* The server opens a __new__ connection to the remote IMAP server:\n  * The appropriate command(s) are executed.\n  * The IMAP server connection is closed.\n* The server sends the response to your client.\n\nThis means that things are slower than they would be if there were a dedicated\nproxy maintaining a persistent connection to the IMAP server.\n\n\n## Missing Features\n\nYou cannot:\n\n* Delete a message.\n* Reply to a message.\n* Forward a message.\n* Compose a fresh message.\n\nSome of those would be simple to add, others more complex.\n\n\n## Hacking\n\nThe generated HTML views are stored inside the compiled binary to ease\ndeployment.  If you wish to tweak the look \u0026 feel by editing them then\nyou're more then welcome.\n\nThe raw HTML-templates are located beneath `data/`, and you can edit them\nthen rebuild the compiled versions via the `implant` tool.\n\nIf you don't already have `implant` installed fetch it like so:\n\n     go get -u  github.com/skx/implant/\n     go install github.com/skx/implant/\n\nNow regenerate the compiled version(s) of the templates and rebuild the\nbinary to make your changes:\n\n    go generate\n    go build\n\n\n## Thanks\n\nThis project wouldn't have been possible without the use of some excellent libraries:\n\n* The go-imap library, which we use extensively:\n  * https://github.com/emersion/go-imap/\n* The enmime library we use for parsing emails, and attachments:\n   * https://github.com/jhillyerd/enmime\n* The following HTML-sanitizer makes the display of HTML-messages less dangerous:\n   * https://github.com/microcosm-cc/bluemonday\n\n\nSteve\n--\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskx%2Fwebmail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskx%2Fwebmail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskx%2Fwebmail/lists"}