docs: improve README.md (#709)

This commit is contained in:
pataar 2022-03-13 23:22:31 +01:00 committed by GitHub
parent 850bb8b2e3
commit f4715076d5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

105
README.md
View File

@ -1,21 +1,54 @@
<p align="center">
<img src="https://raw.githubusercontent.com/mainsail-crew/docs/master/assets/img/logo.png" alt="Sublime's custom image"/>
<a>
<img src="https://raw.githubusercontent.com/mainsail-crew/docs/master/assets/img/logo.png" alt='Mainsail logo' height="152">
<h1 align="center">Mainsail</h1>
</a>
</p>
<p align="center">
Makes Klipper more accessible by adding a lightweight, responsive web user interface, centred around an intuitive and consistent design philosophy.
</p>
<p align="center">
<a aria-label="Downloads" href="https://github.com/mainsail-crew/mainsail/releases">
<img src="https://img.shields.io/github/downloads/mainsail-crew/mainsail/total?style=flat-square">
</a>
<a aria-label="Localization" href="https://docs.mainsail.xyz/development/localization">
<img src="https://shields-staging.herokuapp.com/github/directory-file-count/mainsail-crew/mainsail/src%2Flocales?label=localizations&extension=json&type=file&style=flat-square">
</a>
<a aria-label="Stars" href="https://github.com/mainsail-crew/mainsail/stargazers">
<img src="https://img.shields.io/github/stars/mainsail-crew/mainsail?style=flat-square">
</a>
<a aria-label="Forks" href="https://github.com/mainsail-crew/mainsail/network/members">
<img src="https://img.shields.io/github/forks/mainsail-crew/mainsail?style=flat-square">
</a>
<a aria-label="License" href="https://github.com/mainsail-crew/mainsail/blob/develop/LICENSE">
<img src="https://img.shields.io/github/license/mainsail-crew/mainsail?style=flat-square">
</a>
<a aria-label="Last commit" href="https://github.com/mainsail-crew/mainsail/commits/">
<img src="https://img.shields.io/github/last-commit/meteyou/mainsail?style=flat-square">
</a>
<br />
<a aria-label="Size" href="https://github.com/mainsail-crew/mainsail/">
<img src="https://img.shields.io/github/repo-size/meteyou/mainsail?style=flat-square">
</a>
<a aria-label="Discord" href="https://discord.gg/skWTwTD">
<img src="https://img.shields.io/discord/758059413700345988?color=%235865F2&label=discord&logo=discord&logoColor=white&style=flat-square">
</a>
<a aria-label="Patreon" href="https://www.patreon.com/meteyou">
<img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dmeteyou%26type%3Dpatrons&style=flat-square">
</a>
</p>
# Mainsail
## Getting Started
[![downloads](https://img.shields.io/github/downloads/mainsail-crew/mainsail/total?style=flat-square)](https://github.com/mainsail-crew/mainsail/releases) [![localizations](https://shields-staging.herokuapp.com/github/directory-file-count/mainsail-crew/mainsail/src%2Flocales?label=localizations&extension=json&type=file&style=flat-square)](https://docs.mainsail.xyz/development/localization) [![stars](https://img.shields.io/github/stars/meteyou/mainsail?style=flat-square)](https://github.com/mainsail-crew/mainsail/stargazers) [![forks](https://img.shields.io/github/forks/meteyou/mainsail?style=flat-square)](https://github.com/mainsail-crew/mainsail/network/members)
[![license](https://img.shields.io/github/license/meteyou/mainsail?style=flat-square)](https://github.com/mainsail-crew/mainsail/blob/develop/LICENSE) [![last-commit](https://img.shields.io/github/last-commit/meteyou/mainsail?style=flat-square)](https://github.com/mainsail-crew/mainsail/commits/) ![size](https://img.shields.io/github/repo-size/meteyou/mainsail?style=flat-square)
[![discord](https://img.shields.io/discord/758059413700345988?color=%235865F2&label=discord&logo=discord&logoColor=white&style=flat-square)](https://discord.gg/skWTwTD) [![patreons](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dmeteyou%26type%3Dpatrons&style=flat-square)](https://www.patreon.com/meteyou)
Visit [docs.mainsail.xyz/setup](https://docs.mainsail.xyz/setup) to get started with Mainsail.
Mainsail makes Klipper more accessible by adding a lightweight, responsive web user interface, centred around an intuitive and consistent design philosophy.
Mainsail is also available in remote mode on [http://my.mainsail.xyz](http://my.mainsail.xyz). Find
out [more](https://docs.mainsail.xyz/setup#mymainsailxyz).
[Getting Started](https://docs.mainsail.xyz/setup)
## Documentation
Mainsail is also available in remote mode on [http://my.mainsail.xyz](http://my.mainsail.xyz). Find out [more](https://docs.mainsail.xyz/setup#mymainsailxyz).
[Documentation](https://docs.mainsail.xyz)
[Release Notes](https://github.com/mainsail-crew/mainsail/releases)
Visit [docs.mainsail.xyz](https://docs.mainsail.xyz) to view the full documentation.
You can find the latest release notes [here](https://github.com/mainsail-crew/mainsail/releases).
## Screenshots
@ -24,32 +57,37 @@ Mainsail is also available in remote mode on [http://my.mainsail.xyz](http://my.
## Features
- Responsive web interface, optimized for desktops, tablets and mobile devices
- Supports multiple 3D printers (Printer Farm)
- Localization (i18n)
- File Manager (gcode and config files)
- File Editor (gcode and config files)
- Print History and Statistics
- Job Queue
- Temperature Presets (with custom gcode)
- Bed Mesh visualisation
- G-Code Viewer
- Multi-Webcam support
- Timelapse integration
- Control power devices such as relays, TPLink and Tasmota devices, and more
- Powerful Macro-Management
- Configurable dashboard
- Customizable user interface including logos, backgrounds, and custom CSS
- Exclude objects (not yet officially supported by Klipper)
- **Responsive Web Interface:** _Optimized for desktops, tablets and mobile devices_
- **Printer Farm:** _Supports multiple 3D printers_
- **[Localization](https://docs.mainsail.xyz/features/localization):** _Choose between 12 different languages_
- **File Manager:** _Delete, rename and upload your G-Code and config files_
- **File Editor:** _Edit G-Code and config files with syntax highlighting in your browser_
- **[Print History](https://docs.mainsail.xyz/features/history):** _See your previous prints and their status_
- **[Statistics](https://docs.mainsail.xyz/features/history):** _View how much time your printer has been in use and the number of jobs that have succeeded or failed_
- **Job Queue:** _Queue multiple jobs and add them directly from your slicer_
- **[Temperature Presets](https://docs.mainsail.xyz/features/presets):** _Manage different temperature presets for easy preheating_
- **[Bed Mesh Visualisation](https://docs.mainsail.xyz/features/bedmesh):** _View your bed using a 3D mesh graph_
- **G-Code Viewer:** _View a 3D render of your print and follow the progress_
- **Multi-Webcam Support:** _View your print from different angles with multiple webcams_
- **Timelapse Integration:** _Automatically record a timelapse of your print using [moonraker-timelapse](https://github.com/mainsail-crew/moonraker-timelapse)_
- **Power Control:** _Control power devices such as relays, TP-Link and Tasmota devices, and more_
- **Powerful Macro-Management:** _Manage your macros on a micro level_
- **[Configurable Dashboard](https://docs.mainsail.xyz/features/dashboard-organisation):** _Create your own personal dashboard_
- **[Theming Support](https://docs.mainsail.xyz/features/theming/):** _Customizable user interface including logos, backgrounds, and custom CSS_
- **[Additional Sensors](https://docs.mainsail.xyz/quicktips/additional-sensors):** _Add extra sensors to the temperature graph_
- **Exclude Objects:** _Exclude parts of your print <sup>(not officially supported by Klipper yet)</sup>_
## Help and Support
Do you need help or just want to talk? Join our active community on [Discord](https://discord.gg/skWTwTD).
Have you found a bug? Please create an [Issue](https://github.com/mainsail-crew/mainsail/issues) in GitHub and let us know.
Do you need help or just want to talk? Join our active community on [Discord](https://discord.gg/skWTwTD)!
Did you find a bug or did you thought of a feature?
Please create an [Issue](https://github.com/mainsail-crew/mainsail/issues) in GitHub and let us know.
## Support Mainsail
Mainsail is primarily developed and maintained by meteyou. To keep the project going he invests his free time, almost every day. To motivate him (☕🍺😜) there are several ways to support him:
Mainsail is primarily developed and maintained by meteyou. To keep the project going he invests his free time, almost
every day. To motivate him (☕🍺😜) there are several ways to support him:
[![patreon](https://img.shields.io/badge/patreon-participate-yellow.svg?style=flat-square)](https://www.patreon.com/meteyou)
[![kofi](https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg?style=flat-square)](https://ko-fi.com/mainsail)
@ -62,6 +100,7 @@ Mainsail is primarily developed and maintained by meteyou. To keep the project g
- [Vue.js](https://vuejs.org/): The Progressive JavaScript Framework
- [Vuetify](https://vuetifyjs.com/): Material Design Component Framework for Vue.js
Massive thanks to the whole [Voron Design](http://vorondesign.com/) community. Without them such a project would not be possible.
Massive thanks to the whole [Voron Design](http://vorondesign.com/) community. Without them such a project would not be
possible.
[Full Credits & Licenseinformation](https://docs.mainsail.xyz/credits)
[Full Credits & License information](https://docs.mainsail.xyz/credits)