snappymail/README.md

229 lines
8.9 KiB
Markdown
Raw Normal View History

<div align="center">
<a href="https://github.com/the-djmaze/snappymail">
2021-08-17 21:34:15 +08:00
<img src="https://snappymail.eu/static/img/logo-256x256-white.png">
</a>
<br>
<h1>SnappyMail</h1>
<br>
[![github-actions](https://github.com/the-djmaze/snappymail/actions/workflows/docker.yml/badge.svg)](https://github.com/the-djmaze/snappymail/actions/workflows/docker.yml)
[![docker-image-size](https://img.shields.io/docker/image-size/djmaze/snappymail/latest)](https://hub.docker.com/r/djmaze/snappymail/tags)
<p>
Simple, modern, lightweight &amp; fast web-based email client.
</p>
<p>
The drastically upgraded &amp; secured fork of <a href="https://github.com/RainLoop/rainloop-webmail">RainLoop Webmail Community edition</a>.
</p>
<p>
2020-09-26 18:25:57 +08:00
We thank the RainLoop Team for making a great PHP 5 product that was good in the past.
</p>
<p>
Up to date system requirements, snappy performance, simple installation and upgrade, no database required
- all these make SnappyMail a good choice.
</p>
<h2></h2>
<br>
</div>
For more information about the product, check [snappymail.eu](https://snappymail.eu/).
Information about installing the product, check the [wiki page](https://github.com/the-djmaze/snappymail/wiki/Installation-instructions).
And don't forget to read the [RainLoop documentation](https://www.rainloop.net/docs/).
## License
**SnappyMail** is released under
**GNU AFFERO GENERAL PUBLIC LICENSE Version 3 (AGPL)**.
http://www.gnu.org/licenses/agpl-3.0.html
2023-02-03 22:15:49 +08:00
Copyright (c) 2020 - 2023 SnappyMail
2022-09-02 03:37:32 +08:00
Copyright (c) 2013 - 2022 RainLoop
## Modifications
This fork of RainLoop has the following changes:
2022-11-22 19:05:21 +08:00
* Privacy/GDPR friendly (no: Social, Gravatar, Facebook, Google, Twitter, DropBox, X-Mailer)
* Admin uses password_hash/password_verify
2020-07-15 20:45:11 +08:00
* Auth failed attempts written to syslog
2020-07-29 17:29:59 +08:00
* Added Fail2ban instructions
2021-10-29 19:09:12 +08:00
* ES2018
2022-11-04 19:02:11 +08:00
* PHP 7.4+ required
* PHP mbstring extension required
2021-03-04 19:16:50 +08:00
* PHP replaced pclZip with PharData and ZipArchive
2021-10-29 19:09:12 +08:00
* Dark mode
2021-02-24 18:01:10 +08:00
* Added option to remove background/font colors from messages for real "dark mode"
2020-07-15 20:45:11 +08:00
* Removed BackwardCapability (class \RainLoop\Account)
2021-03-04 19:16:50 +08:00
* Removed ChangePassword (re-implemented as plugin)
2020-07-15 20:45:11 +08:00
* Removed POP3 support
* Removed background video support
* Removed Sentry (Application Monitoring and Error Tracking Software)
2021-10-29 19:09:12 +08:00
* Removed Spyc yaml
2022-11-22 19:05:21 +08:00
* Removed OwnCloud
2020-07-15 20:45:11 +08:00
* Replaced gulp-uglify with gulp-terser
* CRLF => LF line endings
* Embed boot.js and boot.css into index.html
2022-11-22 19:05:21 +08:00
* Removal of old JavaScript code (things are native these days)
2020-09-13 20:13:16 +08:00
* Added modified [Squire](https://github.com/neilj/Squire) HTML editor as replacement for CKEditor
2022-05-22 05:24:50 +08:00
* Updated [Sabre/VObject](https://github.com/sabre-io/vobject)
* Split Admin specific JavaScript code from User code
2022-03-14 22:42:05 +08:00
* Split Sieve specific JavaScript code from User code
2020-10-29 00:12:33 +08:00
* JSON reviver
* Better memory garbage collection management
* Added serviceworker for Notifications
2021-01-22 00:37:41 +08:00
* Added advanced Sieve scripts editor
* Slimmed down language files
* Replaced webpack with rollup
2021-02-17 23:31:29 +08:00
* No user-agent detection (use device width)
2021-03-04 19:16:50 +08:00
* Added support to load plugins as .phar
2021-04-20 02:44:12 +08:00
* Replaced old Sabre library
* AddressBook Contacts support MySQL/MariaDB utf8mb4
2021-07-16 22:24:07 +08:00
* Added [Fetch Metadata Request Headers](https://www.w3.org/TR/fetch-metadata/) checks
2021-08-10 21:24:46 +08:00
* Reduced excessive DOM size
2021-10-29 19:09:12 +08:00
* Support [Kolab groupware](https://kolab.org/)
2023-12-04 09:03:57 +08:00
* Support many more [IMAP RFC's](https://snappymail.eu/comparison#IMAP)
2021-11-12 17:00:59 +08:00
* Support Sodium and OpenSSL for encryption
2022-02-07 19:29:19 +08:00
* Much better PGP support
2021-10-29 19:09:12 +08:00
2020-07-15 20:45:11 +08:00
### Supported browsers
2020-07-27 23:40:00 +08:00
This fork uses downsized/simplified versions of scripts and has no support for Internet Explorer nor Edge Legacy.
Supported are:
2022-09-02 03:37:32 +08:00
* Chrome 80+
* Edge 80+
* Firefox 78+
2022-09-02 03:37:32 +08:00
* Opera 67+
* Safari 13.1+
2020-07-28 17:23:06 +08:00
### Removal of old JavaScript
The result is faster and smaller download code (good for mobile networks).
2020-07-24 02:50:20 +08:00
* Added dev/prototype.js for some additional features
* Modified Jua.js to be without jQuery
2020-08-31 22:33:40 +08:00
* Replaced Autolinker with simple https/email detection
2021-10-29 19:09:12 +08:00
* Replaced momentToNode with proper HTML5 `<time>`
2020-08-31 22:33:40 +08:00
* Replaced resize listeners with ResizeObserver
* Replaced bootstrap.js with native drop-in replacement
* Replaced dev/Common/ClientStorageDriver/* with Web Storage Objects polyfill
* Replaced *Ajax with *Fetch classes because we use the Fetch API, not jQuery.ajax
2021-07-29 17:43:47 +08:00
* Replaced [knockoutjs](https://github.com/knockout/knockout) 3.4 with a modified 3.5.1
* Replaced knockout-sortable with native HTML5 drag&drop
* Replaced simplestatemanager with CSS @media
* Replaced inputosaurus with own code
* Replaced keymaster with own shortcuts handler
2022-11-22 19:05:21 +08:00
* Replaced OpenPGP.js v2 with OpenPGP.js v5
* Removed ifvisible.js
* Removed pikaday
* Removed underscore
* Removed polyfills
* Removed Modernizr
* Removed nanoscroll
2020-09-22 00:54:41 +08:00
* Removed lightgallery
* Removed jQuery
* Removed jquery-ui
* Removed jquery-scrollstop
* Removed jquery-mousewheel
* Removed matchmedia-polyfill
* Removed momentjs (use Intl)
2020-08-13 19:16:08 +08:00
* Removed opentip (use CSS)
* Removed non-community (aka Prem/Premium/License) code
2021-10-29 19:09:12 +08:00
* Removed ProgressJS
2022-09-02 03:37:32 +08:00
RainLoop 1.17 vs SnappyMail
|js/* |RainLoop |Snappy |
|--------------- |--------: |--------: |
2023-12-04 09:03:57 +08:00
|admin.js |2.170.153 | 80.467 |
2023-12-09 05:24:04 +08:00
|app.js |4.207.787 | 407.517 |
2023-02-25 02:47:39 +08:00
|boot.js | 868.735 | 4.142 |
2023-12-09 05:24:04 +08:00
|libs.js | 658.812 | 192.287 |
2023-12-04 09:03:57 +08:00
|sieve.js | 0 | 85.085 |
2022-09-02 03:37:32 +08:00
|polyfills.js | 334.608 | 0 |
|serviceworker.js | 0 | 285 |
2023-12-09 05:24:04 +08:00
|TOTAL |8.240.095 | 769.783 |
2021-01-27 19:02:37 +08:00
|js/min/* |RainLoop |Snappy |RL gzip |SM gzip |RL brotli |SM brotli |
|--------------- |--------: |--------: |------: |------: |--------: |--------: |
2023-12-04 09:03:57 +08:00
|admin.min.js | 256.831 | 39.328 | 73.606 | 13.191 | 60.877 | 11.815 |
2023-12-09 05:24:04 +08:00
|app.min.js | 515.367 | 186.005 |139.456 | 63.143 |110.485 | 54.149 |
2023-02-25 02:47:39 +08:00
|boot.min.js | 84.659 | 2.084 | 26.998 | 1.202 | 23.643 | 1.003 |
2023-12-09 05:24:04 +08:00
|libs.min.js | 584.772 | 93.758 |180.901 | 34.878 |155.182 | 31.291 |
2023-12-04 09:03:57 +08:00
|sieve.min.js | 0 | 41.316 | 0 | 10.364 | 0 | 9.352 |
2022-09-02 03:37:32 +08:00
|polyfills.min.js | 32.837 | 0 | 11.406 | 0 | 10.175 | 0 |
2023-12-09 05:24:04 +08:00
|TOTAL user |1.217.635 | 281.847 |358.761 | 99.223 |299.485 | 86.443 |
|TOTAL user+sieve |1.217.635 | 323.163 |358.761 |109.587 |299.485 | 95.795 |
|TOTAL admin | 959.099 | 135.170 |292.911 | 49.271 |249.877 | 44.109 |
2021-05-19 21:58:37 +08:00
2023-12-09 05:24:04 +08:00
For a user it is around 69% smaller and faster than traditional RainLoop.
2020-08-31 22:33:40 +08:00
### CSS changes
2021-01-27 19:02:37 +08:00
* Solve jQuery removed "features" with native css code
* Themes work in mobile mode
* Bugfix invalid/conflicting css rules
2021-02-17 23:31:29 +08:00
* Use flexbox
2022-11-22 19:05:21 +08:00
* Use border-box
2021-07-29 17:43:47 +08:00
* Split app.css to have separate admin.css
2021-02-17 23:31:29 +08:00
* Remove oldschool 'float'
* Remove unused css
2020-08-31 22:33:40 +08:00
* Removed html.no-css
* Removed dev/Styles/Cmd.less
* Removed dev/Styles/Scroll.less
* Removed Internet Explorer from normalize.css
* Removed node_modules/opentip/css/opentip.css
* Removed node_modules/pikaday/css/pikaday.css
* Removed unused vendors/bootstrap/less/*
2020-08-31 22:33:40 +08:00
* Removed vendors/jquery-nanoscroller/nanoscroller.css
* Removed vendors/jquery-letterfx/jquery-letterfx.min.css
* Removed vendors/Progress.js/minified/progressjs.min.css
* Removed gulp-autoprefixer
|css/* |RainLoop |Snappy |RL gzip |SM gzip |SM brotli |
2021-07-21 02:53:11 +08:00
|------------ |-------: |------: |------: |------: |--------: |
2023-12-04 09:03:57 +08:00
|app.css | 340.331 | 84.570 | 46.946 | 17.646 | 15.118 |
|app.min.css | 274.947 | 67.928 | 39.647 | 15.529 | 13.548 |
2021-07-21 02:53:11 +08:00
|boot.css | | 1.326 | | 664 | 545 |
|boot.min.css | | 1.071 | | 590 | 474 |
2023-10-02 23:05:42 +08:00
|admin.css | | 30.645 | | 7.024 | 6.117 |
|admin.min.css | | 24.746 | | 6.346 | 5.608 |
### PGP
RainLoop uses the old OpenPGP.js v2
SnappyMail v2.12 uses OpenPGP.js v5, GnuPG and Mailvelope.
SnappyMail is able to use and generate ECDSA and EDDSA keys, where RainLoop does not.
2022-01-31 18:54:13 +08:00
Since SnappyMail tries to achieve the best mobile experience, it forked OpenPGP.js to strip it down.
* remove all unused Node.js
* remove all old browsers support
See https://github.com/the-djmaze/openpgpjs for development
|OpenPGP |RainLoop |Snappy |RL gzip |SM gzip |RL brotli |SM brotli |
|--------------- |--------: |--------: |------: |-------: |--------: |--------: |
2023-02-25 02:47:39 +08:00
|openpgp.min.js | 330.742 | 541.176 |102.388 | 168.266 | 84.241 | 138.278 |
|openpgp.worker | 1.499 | | 824 | | 695 | |
### Squire vs CKEditor
The [Squire](https://github.com/neilj/Squire) implementation is not 100% compatible yet, but it shows the massive overhead of CKEditor.
Still TODO:
* support for tables (really needed?!?)
| | normal | min | gzip | min gzip |
|-------- |-------: |-------: |------: |--------: |
2021-09-01 18:21:08 +08:00
|squire | 122.321 | 41.906 | 31.867 | 14.330 |
|ckeditor | ? | 520.035 | ? | 155.916 |
CKEditor including the 7 asset requests (css,language,plugins,icons) is 633.46 KB / 180.47 KB (gzip).
2021-03-25 20:35:15 +08:00
To use the old CKEditor, you must install the plugin.