diff --git a/docs/desktop/gnome/decoder.md b/docs/desktop/gnome/decoder.md new file mode 100644 index 0000000000..9bd062b8a5 --- /dev/null +++ b/docs/desktop/gnome/decoder.md @@ -0,0 +1,82 @@ +--- +title: Decoder +author: Christine Belzie +contributors: +--- + +## Introduction + +Need a QR code for your website, app, and social media profiles? Check out Decoder! :) It is an application that lets you can create, save, an export QR codes. + +## Assumptions + +This guide assumes you have the following: + +- Rocky Linux +- Flatpak +- FlatHub + +## Installation Process + +1. Go to the Flathub website, type "Decoder" in the search bar, and click on **Install**. +![Screenshot of the install button being highlighted by a red rectangle](images/01_decoder.png) + +1. Then, run the following command in your terminal +`flatpak run com.belmoussaoui.Decoder` + +## How to Create a QR Code + +There are two types of QR codes you can create on Decoder. Choose the option that best suits your needs: + +- [Text](#text) +- [Wifi](#wifi) + +### Text + +1. Click on the **Text** button +![Screenshot of a red arrow pointing next to a grey button with the word, Scan written in black font](images/02_decoder-text.png) +1. Add a link to your desired website and add a description +![Screenshot of a red arrow pointing upwards the text box, containing the description "Check out this song" with a Youtube link next to it ](images/03_decoder-text.png) +1. Click on **Create** +![Screenshot of a red arrow pointing next to a grey button that has a QR code symbol and the word "Create" underneath it. ](images/04_decoder-text.png) +1. Click on **Save** +![Screenshot of a red arrow pointing next to a grey button that has the word "Save" written in black. ](images/05_decoder-text.png) +1. Click on **Export** +![Screenshot of a red arrow pointing next to a grey button that has the word "Export" written in black. ](images/06_decoder-text.png) + +### Wifi + +1. Click on the **Wifi** button +![Screenshot of a red arrow pointing at a grey button that has the word "Wifi" written in black.](images/01_decoder-wifi.png) +1. Add the name of your network, password, and pick its form of protection from the encryption algorithm dropdown menu +![Screenshot the wifi's name, password, and encryption algorithm being displayed. ](images/02_decoder-wifi.png) +1. Click on **Export** +![Screenshot of a red arrow pointing at a grey button that has the word "Export" written in black.](images/03_decoder-wifi.png) +1. Click on **Save** +![Screenshot of a red arrow pointing at a grey button that has the word "Save" written in black.](images/04_decoder-wifi.png) + +!!! tip + + If your wifi network is hidden, click on the **Hidden** button. + +### How to Scan a QR code + +In addition to creating and generating QR codes, you can use Decoder to scan QR codes you saved on you computer. Here's how: + +1. Click on **Scan** +![Screenshot of a red circle on a grey button that has the word "Scan" written in black.](images/01_decoder-scan.png) +1. Click on **From a Screenshot** +![Screenshot of a red rectangle on a blue button that has the word "From a Screenshot" written in white.](images/02_decoder-scan.png) +1. Pick your desired effects and click on **Take a Screenshot** +![Screenshot of a grey square surrounding the options menu with a red arrow pointing towards it and the number one written on top. Next, there is a red square surrounding the "Take a Screenshot" button with a red arrow pointing upwards with the number two written underneath it.](images/03_decoder-scan.png) +1. Click on **Share** +![Screenshot of a red arrow pointing at a blue button that has the word "Share" written in white.](images/04_decoder-scan.png) +1. Scan the QR code with your mobile device + +!!! note + + To scan a QR code straight from your computer, ensure that you grant the app access to your computer's camera. + +## Conclusion + +Whether it's to share a restaurant's Wi-Fi with friends, grow your business, or network with other professionals at a conference, Decoder can ease the process of creating and scanning QR codes. Eager to learn more about or have more ideas for this application? [Submit an issue to its repository at GitLab](https://gitlab.gnome.org/World/decoder/-/issues). diff --git a/docs/desktop/gnome/images/01_decoder-scan.png b/docs/desktop/gnome/images/01_decoder-scan.png new file mode 100644 index 0000000000..03e18dd164 Binary files /dev/null and b/docs/desktop/gnome/images/01_decoder-scan.png differ diff --git a/docs/desktop/gnome/images/01_decoder-wifi.png b/docs/desktop/gnome/images/01_decoder-wifi.png new file mode 100644 index 0000000000..5b00d2cfea Binary files /dev/null and b/docs/desktop/gnome/images/01_decoder-wifi.png differ diff --git a/docs/desktop/gnome/images/01_decoder.png b/docs/desktop/gnome/images/01_decoder.png new file mode 100644 index 0000000000..e9d058bb51 Binary files /dev/null and b/docs/desktop/gnome/images/01_decoder.png differ diff --git a/docs/desktop/gnome/images/02_decoder-scan.png b/docs/desktop/gnome/images/02_decoder-scan.png new file mode 100644 index 0000000000..5e7258783a Binary files /dev/null and b/docs/desktop/gnome/images/02_decoder-scan.png differ diff --git a/docs/desktop/gnome/images/02_decoder-text.png b/docs/desktop/gnome/images/02_decoder-text.png new file mode 100644 index 0000000000..a2985495c0 Binary files /dev/null and b/docs/desktop/gnome/images/02_decoder-text.png differ diff --git a/docs/desktop/gnome/images/02_decoder-wifi.png b/docs/desktop/gnome/images/02_decoder-wifi.png new file mode 100644 index 0000000000..07338624cf Binary files /dev/null and b/docs/desktop/gnome/images/02_decoder-wifi.png differ diff --git a/docs/desktop/gnome/images/03_decoder-scan.png b/docs/desktop/gnome/images/03_decoder-scan.png new file mode 100644 index 0000000000..c7ecd7bab7 Binary files /dev/null and b/docs/desktop/gnome/images/03_decoder-scan.png differ diff --git a/docs/desktop/gnome/images/03_decoder-text.png b/docs/desktop/gnome/images/03_decoder-text.png new file mode 100644 index 0000000000..e7fce9b42c Binary files /dev/null and b/docs/desktop/gnome/images/03_decoder-text.png differ diff --git a/docs/desktop/gnome/images/03_decoder-wifi.png b/docs/desktop/gnome/images/03_decoder-wifi.png new file mode 100644 index 0000000000..decfa1bc5c Binary files /dev/null and b/docs/desktop/gnome/images/03_decoder-wifi.png differ diff --git a/docs/desktop/gnome/images/04_decoder-scan.png b/docs/desktop/gnome/images/04_decoder-scan.png new file mode 100644 index 0000000000..72b0d58ce1 Binary files /dev/null and b/docs/desktop/gnome/images/04_decoder-scan.png differ diff --git a/docs/desktop/gnome/images/04_decoder-text.png b/docs/desktop/gnome/images/04_decoder-text.png new file mode 100644 index 0000000000..67a4145301 Binary files /dev/null and b/docs/desktop/gnome/images/04_decoder-text.png differ diff --git a/docs/desktop/gnome/images/04_decoder-wifi.png b/docs/desktop/gnome/images/04_decoder-wifi.png new file mode 100644 index 0000000000..887cea358c Binary files /dev/null and b/docs/desktop/gnome/images/04_decoder-wifi.png differ diff --git a/docs/desktop/gnome/images/05_decoder-text.png b/docs/desktop/gnome/images/05_decoder-text.png new file mode 100644 index 0000000000..d25c5c49e4 Binary files /dev/null and b/docs/desktop/gnome/images/05_decoder-text.png differ diff --git a/docs/desktop/gnome/images/06_decoder-text.png b/docs/desktop/gnome/images/06_decoder-text.png new file mode 100644 index 0000000000..bba49791d6 Binary files /dev/null and b/docs/desktop/gnome/images/06_decoder-text.png differ diff --git a/docs/desktop/gnome/images/gnome_extensions_images/04_decoder-scan.png b/docs/desktop/gnome/images/gnome_extensions_images/04_decoder-scan.png new file mode 100644 index 0000000000..c7ecd7bab7 Binary files /dev/null and b/docs/desktop/gnome/images/gnome_extensions_images/04_decoder-scan.png differ