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: Update Quicktips #518

Merged
merged 15 commits into from
Jan 18, 2022
Merged

Conversation

prcutler
Copy link
Contributor

@prcutler prcutler commented Jan 6, 2022

I've reviewed all the pages in Quicktips and updated them for readability, spelling, grammar and consistency. The only page I haven't done yet is the Slicer page.

Please review and let me know if I missed anything or have any errors.

Thanks!

@prcutler prcutler changed the title :docs Update Quicktips docs: Update Quicktips Jan 6, 2022

The following table applies to Mainsail when installed locallaly, or accessed via [my.mainsail.xyz](http://my.mainsail.xyz).
The following table applies to Mainsail when installed locallly or accessed remotely at [my.mainsail.xyz](http://my.mainsail.xyz).
Copy link
Contributor

Choose a reason for hiding this comment

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

locally


Run `ls /dev/v4l/by-id`, copy your camera id and paste it into the editor in mainsail. For example:
In a termina, run the comman `ls /dev/v4l/by-id`, copy your camera id and paste it into the editor in Mainsail. For example:
Copy link
Contributor

Choose a reason for hiding this comment

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

terminal


Set `camera="usb"` at the top, and the `camera_usb_options` line to indicate the device:
Add `camera="usb"` at the beginning of the file and then add a line with `camera_usb_options` to indicate the device:
Copy link
Contributor

Choose a reason for hiding this comment

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


`camera_usb_options="-r 640x480 -f 10 -d /dev/v4l/by-id/<device long id>"`

__Note__
Using a Raspberry Pi camera? Set camera="raspi" at the top of the file, and you can ignore referencing the cameras by device ID.
If you are using a Raspberry Pi branded camera, seet camera="raspi" at the top of the file and you do not have to reference the cameras by device ID.
Copy link
Contributor

Choose a reason for hiding this comment

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

seet -> set


As above again, set camera="usb" and set camera_usb_options but this time using the ID for the second camera:
Edit `/home/pi/klipper_config/webcam2.txt` as described above andd add:
Copy link
Contributor

Choose a reason for hiding this comment

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

andd -> and

Copy link
Contributor

Choose a reason for hiding this comment

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

same about "add" as above.


Adjust the port, by editing camera_http_options:
Adjust the port by editing `camera_http_options`:
Copy link
Contributor

Choose a reason for hiding this comment

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

If you need more than four webcams, hop onto our [Discord](https://discord.gg/skWTwTD){:target="_blank"} and we will help you.
MainsailOS comes setup with four nginx reverse proxies for port 8080 through 8083, so you can configure 4 webcams with this guide.
For more webcams you will need to edit the nginx configuration, which is not recommended. It can be easy to make a mistake when editing nginx, which will also cause Mainsail to stop working.
If you need more than four webcams,visit us on [Discord](https://discord.gg/skWTwTD){:target="_blank"} and we will help you.
Copy link
Contributor

Choose a reason for hiding this comment

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

",visit" -> add space ", visit"


To be able to reach your home network even with a non-static IP address, you should use a dynamic DNS service. This will forward a domain directly to your IP address. Often, these DynDNS services can also be set up directly in the router, so that the IP address gets automatically updated on a change.
If your router does not support this, you can also set up your own VPN, for example, using your Raspberry Pi.
[OpenVPN](https://openvpn.net/), [WireGuard](https://www.wireguard.com/) or [PiVPN](https://www.pivpn.io/)are all options that could work.
Copy link
Contributor

Choose a reason for hiding this comment

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

add a space between the PiVPN link and "are"


__Notice__
The devices that dial in via the VPN tunnel are assigned to a different address range. This address range must be configured in moonraker under _trusted_clients_ and _cors_domains_. [https://moonraker.readthedocs.io/en/latest/configuration/#authorization](https://moonraker.readthedocs.io/en/latest/configuration/#authorization) <br/><br/>
The devices that you use to access VPN tunnel are assigned to a different address range. This address range must be configured in Moonraker under _trusted_clients_ and _cors_domains_.See also [https://moonraker.readthedocs.io/en/latest/configuration/#authorization](https://moonraker.readthedocs.io/en/latest/configuration/#authorization) <br/><br/>
Copy link
Contributor

Choose a reason for hiding this comment

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

space in front of "See also".


```
[octoprint_compat]
```


### PrusaSlicer/SuperSlicer (prior to v2.3.0)
### PrusaSlicer / SuperSlicer (Mainsail v2.3.0 and up)
Copy link
Contributor

Choose a reason for hiding this comment

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

Nope, not Mainsail. It's about the slicers. They changed at some point how to connect to the printers.


If not already been done, switch to advanced or expert mode and set the options under `Printer Settings / General` as shown in the screenshot below.
### PrusaSlicer / SuperSlicer (prior to Mainsail v2.3.0)
Copy link
Contributor

Choose a reason for hiding this comment

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

Same as above.

@@ -13,7 +13,7 @@ description: >-

## Moonraker.conf

Add the following section to your printers moonraker.conf:
To enable updates in Moonraker's web interface, add the following section to your printer's `moonraker.conf`:
Copy link
Contributor

Choose a reason for hiding this comment

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

*Mainsail's web interface

Copy link
Contributor

@lixxbox lixxbox left a comment

Choose a reason for hiding this comment

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

I have added a few minor change requests.

The changes in console-shortcuts.md can be done for the moment, but the page needs a complete overhaul, because the functionality of the console has changed a bit. we can discuss this in the discord. :)

@lixxbox lixxbox added the Is: Docs Anything referencing documentation label Jan 7, 2022
@prcutler prcutler requested a review from lixxbox January 7, 2022 12:47
@lixxbox lixxbox merged commit be2efac into mainsail-crew:develop Jan 18, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Is: Docs Anything referencing documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants