Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(README): rework README header and content #346

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/images/community-logos.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
70 changes: 49 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,38 +1,66 @@
# Fluidd
Fluidd is a free and open-source Klipper web interface for managing your 3d printer.
<h4 align="center">
<img src="docs\assets\images\fluidd_icon.svg">
</h4>

![Fluidd](/.github/images/preview_sliced.png?raw=true "Fluidd")
<h4 align="center">
<a href="https://github.com/cadriel/fluidd/releases/latest/download/fluidd.zip">📜 Download</a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a href="https://github.com/cadriel/fluidd/releases/latest/download/fluidd.zip">📜 Download</a>
<a href="https://github.com/fluidd-core/fluidd/releases/latest/download/fluidd.zip">📜 Download</a>

&nbsp;|&nbsp;
<a href="https://docs.fluidd.xyz/">📖 Docs</a>
&nbsp;|&nbsp;
<a href="https://docs.fluidd.xyz/faq">💭 FAQ</a>
&nbsp;|&nbsp;
<a href="https://docs.fluidd.xyz/configuration">⚙️ Configs</a>
&nbsp;|&nbsp;
<a href="https://github.com/cadriel/fluidd/blob/master/CONTRIBUTING.md">🧱 Contribute</a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a href="https://github.com/cadriel/fluidd/blob/master/CONTRIBUTING.md">🧱 Contribute</a>
<a href="https://github.com/fluidd-core/fluidd/blob/master/CONTRIBUTING.md">🧱 Contribute</a>

</h4>

## Features
- Responsive UI, supports desktop, tablets and mobile
- Customizable layouts. Move any panel where YOU want
- Built-in color themes
- Manage multiple printers from one Fluidd install
- [See our docs for more!](https://docs.fluidd.xyz)
<h4 align="center">
<a href="" target="__blank"><img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/cadriel/fluidd?label=latest&style=flat-square"></a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a href="" target="__blank"><img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/cadriel/fluidd?label=latest&style=flat-square"></a>
<a href="https://github.com/fluidd-core/fluidd/releases/latest" target="__blank"><img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/fluidd-core/fluidd?label=latest&style=flat-square"></a>

<a href="" target="__blank"><img alt="GitHub downloads" src="https://img.shields.io/github/downloads/cadriel/fluidd/total?style=flat-square"></a>
<a href="" target="__blank"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/cadriel/fluidd?style=flat-square"></a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a href="" target="__blank"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/cadriel/fluidd?style=flat-square"></a>
<a href="https://hub.docker.com/r/cadriel/fluidd" target="__blank"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/cadriel/fluidd?style=flat-square"></a>

<a href="" target="__blank"><img alt="GitHub language count" src="https://img.shields.io/github/languages/count/cadriel/fluidd?style=flat-square"></a>
<img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/cadriel/fluidd?style=flat-square"></a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/cadriel/fluidd?style=flat-square"></a>
<a href="https://github.com/fluidd-core/fluidd/commits/develop" target="__blank"><img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/cadriel/fluidd?style=flat-square"></a>

</h4>

## Support & Documentation
See our [Docs](https://docs.fluidd.xyz).
Join our [Discord!](https://discord.gg/GZ3D5tqfcF).
<img align="right" src=".github\images\community-logos.png" alt="Community Logos" width="250"/>

## Where to download?
You can download the latest release [here](https://github.com/cadriel/fluidd/releases/latest).
## Key Features

Older releases can be found [here](https://github.com/cadriel/fluidd/releases).
- Responsive UI made for *desktop, tablet & mobile*!
- Customize you dashboard! Choose what you want to see and move every panel where YOU want!
Copy link
Member

@matmen matmen Feb 21, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Customize you dashboard! Choose what you want to see and move every panel where YOU want!
- Customize your dashboard! Choose what you want to see and move every panel where YOU want!

- Built-in color and community themes, pick a logo you like!
- Manage multiple printers from one Fluidd install!
- Fast development cycle and active devs!
- Multi language support!
- [See our docs for a lot more!](https://docs.fluidd.xyz)

## Docker
We have an official docker image. This is updated for each release.
https://hub.docker.com/r/cadriel/fluidd
# Support & Documentation
<p>
<a href="" target="__blank"><img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/cadriel/fluidd?style=flat-square"></a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a href="" target="__blank"><img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/cadriel/fluidd?style=flat-square"></a>
<a href="https://github.com/fluidd-core/fluidd/issues" target="__blank"><img alt="GitHub open issues" src="https://img.shields.io/github/issues/cadriel/fluidd?style=flat-square"></a>

<a href="" target="__blank"><img alt="Discord" src="https://img.shields.io/discord/762863525818662974?label=discord&style=flat-square&logo=discord"></a>
</p>

Looking for support? [Check out our docs](https://docs.fluidd.xyz) or [open an issue](https://github.com/cadriel/fluidd/issues/new/choose)!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Looking for support? [Check out our docs](https://docs.fluidd.xyz) or [open an issue](https://github.com/cadriel/fluidd/issues/new/choose)!
Looking for support? [Check out our docs](https://docs.fluidd.xyz) or [open an issue](https://github.com/fluidd-core/fluidd/issues/new/choose)!


Have a killer idea you'd like to see implemented? Join our [Discord](https://discord.gg/GZ3D5tqfcF) to discuss bugs, features and share fireside fluidd stories.

# Where can I get it?
You can get your hands on the latest release of *fluidd* [here](https://github.com/cadriel/fluidd/releases/latest), while older releases can be found [here](https://github.com/cadriel/fluidd/releases).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can get your hands on the latest release of *fluidd* [here](https://github.com/cadriel/fluidd/releases/latest), while older releases can be found [here](https://github.com/cadriel/fluidd/releases).
You can get your hands on the latest release of *fluidd* [here](https://github.com/fluidd-core/fluidd/releases/latest), while older releases can be found [here](https://github.com/fluidd-core/fluidd/releases).


We also have an official docker image! This is updated for each release and can be found [here](https://hub.docker.com/r/cadriel/fluidd).


# How do I use it?

## How to use?
Fluidd is distributed as a RaspbiOS image, with Fluidd pre-installed and setup alongside its dependencies.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Fluidd is distributed as a RaspbiOS image, with Fluidd pre-installed and setup alongside its dependencies.
Fluidd is distributed as a Raspberry Pi OS image, with Fluidd pre-installed and setup alongside its dependencies.


The recommended approach is to flash a fresh image using FluiddPI.

Please see the [docs](https://docs.fluidd.xyz) for help with installation and configuration.
Copy link
Member

@matmen matmen Feb 21, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Please see the [docs](https://docs.fluidd.xyz) for help with installation and configuration.
Please refer to the [docs](https://docs.fluidd.xyz/installation) for help with installation and configuration.


### Credit
# Credit
A big thank you to;
Copy link
Member

@matmen matmen Feb 21, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A big thank you to;
A big thank you to:


- the [Voron Community](http://vorondesign.com/)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add the other communities here?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great idea, let me add those!

- Kevin O'Connor for [Klipper](https://github.com/KevinOConnor/klipper)
- Eric Callahan for [Moonraker](https://github.com/Arksine/moonraker)
- Ray for [MainsailOS](https://github.com/raymondh2/MainsailOS)