> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oryx.mechatronstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> From the welcome screen to your first signal.

## 1. Sign in

When you open the app the **welcome screen** appears: on the left what the app
is, on the right what you can do. Until you sign in the window cannot be closed
—not with `Esc`, not by clicking outside, not with the cross— and the right
panel shows the sign-in form.

Three chained forms:

<Steps>
  <Step title="Create account">
    Name, email and repeated password.
  </Step>

  <Step title="Sign in">
    Email and password.
  </Step>

  <Step title="Recover password">
    Just the email. It always answers the same, whether the account exists or
    not.
  </Step>
</Steps>

<Note>
  Your session is remembered, so next time you open the app you go straight in.
</Note>

## 2. Pick where to start

Once signed in, the right panel offers four cards:

| Card             | What it does                                                    |
| ---------------- | --------------------------------------------------------------- |
| **New project**  | Asks for the mode —digital or analog— and opens a blank project |
| **Open project** | Lists the projects saved in your account                        |
| **Account**      | Your details and subscription                                   |
| **Settings**     | Editor preferences                                              |

You can also close the welcome screen and **go to the editor** as it is.

## 3. Draw the signal

<Tabs>
  <Tab title="Digital">
    1. The timeline starts with **two channels** and **16 steps** (the default,
       adjustable in Settings).
    2. Click a cell to set it high or low.
    3. Drag to select a stretch; `Shift + click` extends the selection.
    4. With a selection made, the bottom bar enables **Copy, Cut, Paste, Label,
       Delete, Insert, Toggle, Invert, Division and Offset**.
    5. `+` and `−` add and remove steps. `Z` fits the zoom to the screen.

    Full detail in [Digital editing](/en/editor/digital-editing).
  </Tab>

  <Tab title="Analog">
    1. Click on a **divider** to pin a point at the height set by the **Y Axis**
       control.
    2. A **chord** is stretched between every two consecutive points, straight
       out of the box.
    3. Click the chord to select it: that enables **X Axis** (where you grab
       it), **Y Axis** (how high you pull it) and **Radius** (how much the peak
       is rounded).
    4. Double-click a point to delete it.

    Full detail in [Analog editing](/en/editor/analog-editing).
  </Tab>
</Tabs>

## 4. Organize the channels

The **Channels** button in the header opens the organizer: up to **16
channels**, of which the timeline draws **4 at a time**. There you reorder them
by dragging, change their color, hide, duplicate and delete them.

See [Channels](/en/editor/channels).

## 5. Take the signal out

<Tabs>
  <Tab title="To a file">
    The **Export** button in the menu, or the `G` key.

    1. Choose the file name.
    2. In analog, the **resolution**: 8, 10, 12 or 16 bits.
    3. Optionally include the **hidden channels**.
    4. Optionally add **metadata**: voltage, step time (µs) and cycles (RPM).
       Every field is optional.

    A `.txt` is downloaded. See [Export the project](/en/export/export-project).
  </Tab>

  <Tab title="To an ESP32">
    The **Device** button in the header.

    1. Flash the firmware onto the board (once).
    2. **Choose port** → the browser lists the serial ports.
    3. **Send signal** → the whole signal travels to the device memory.
    4. **Start signal** → the device plays it on its outputs.

    See [Connect the device](/en/device/connect).
  </Tab>
</Tabs>

## Shortcuts worth knowing from day one

| Key                 | What it does                                 |
| ------------------- | -------------------------------------------- |
| `?` or `H`          | Opens the shortcut help                      |
| `S`                 | Selects the step at the center of the screen |
| `Space`             | Toggles high / low                           |
| `Z` or `Ctrl+0`     | Fits the zoom to the screen                  |
| `G`                 | Export                                       |
| `Ctrl+Z` / `Ctrl+Y` | Undo / redo                                  |

The whole list is in [Keyboard shortcuts](/en/editor/shortcuts).