speedtest/README.md

64 lines
2.3 KiB
Markdown
Raw Normal View History

2016-11-28 20:09:12 +00:00
# HTML5 Speedtest
2016-03-04 11:48:09 +00:00
No Flash, No Java, No Websocket, No Bullshit.
2016-11-28 20:09:12 +00:00
This is a very lightweight Speedtest implemented in Javascript, using XMLHttpRequest and Web Workers.
2016-03-04 11:48:09 +00:00
## Try it
2017-02-02 07:05:42 +00:00
[Take a Speedtest](http://speedtest.fdossena.com)
2016-03-04 11:48:09 +00:00
## Compatibility
Only modern browsers are supported (IE11, latest Edge, latest Chrome, latest Firefox, latest Safari)
2016-03-04 11:48:09 +00:00
## Features
* Download
* Upload
* Ping
* Jitter
* IP Address
* Telemetry (optional)
2016-03-04 11:48:09 +00:00
## Requirements
- A reasonably fast web server with PHP (see doc.md for details and use without PHP)
- Your server must accept large POST requests (up to 20 Megabytes), otherwise the upload test will fail
2016-11-28 20:09:12 +00:00
- It's also better if your server does not use compression, but it's not mandatory
2016-03-04 11:48:09 +00:00
2017-06-19 15:27:52 +00:00
## Quick installation videos
* [Debian 9.0 with Apache](https://fdossena.com/?p=speedtest/quickstart_deb.frag)
* [Windows Server 2016 with IIS](https://fdossena.com/?p=speedtest/quickstart_win.frag)
2018-03-17 10:16:01 +00:00
* [Ubuntu (External)](https://freedif.org/how-to-install-selfhosted-speedtest)
2017-06-19 15:27:52 +00:00
2017-07-13 14:22:01 +00:00
Also, here's an [example config on Ubuntu 16 LTS](https://github.com/adolfintel/speedtest/issues/50)
2017-06-19 15:27:52 +00:00
## How to use in your site
2018-04-25 14:58:58 +00:00
* See the examples
* [Read the wiki](https://github.com/adolfintel/speedtest/wiki)
* Read doc.md
2016-03-04 11:48:09 +00:00
2017-06-24 08:38:37 +00:00
## Docker
Please see the ```docker``` branch
2018-04-22 17:26:54 +00:00
## Node.js backend
A Node.js implementation is available in the ```node``` branch, maintained by [dunklesToast](https://github.com/dunklesToast).
2017-06-26 11:18:57 +00:00
## Donate
2018-04-25 14:56:53 +00:00
[![Donate with Liberapay](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/fdossena/donate)
[Donate with PayPal](https://www.paypal.me/sineisochronic)
Send ETH at this address: ```0x8A5273d4e2618c4cff2C62d8EB731701FceEd8E3```
2017-06-26 11:18:57 +00:00
2016-03-04 11:48:09 +00:00
## License
2018-02-17 08:47:21 +00:00
Copyright (C) 2016-2018 Federico Dossena
2016-03-04 11:48:09 +00:00
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see <https://www.gnu.org/licenses/lgpl>.