# How to Use the `n` Prefix to Skip Updates When Running osu-winello Commands

> Learn how to use the n prefix with osu-winello commands to easily skip update checks for launchers and Wine components. Streamline your workflow today.

- Repository: [NelloKudo/osu-winello](https://github.com/nellokudo/osu-winello)
- Tags: how-to-guide
- Published: 2026-03-08

---

**Prepend any osu-winello command with the letter `n` to bypass automatic update checks for the launcher script and Wine components.**

The `osu-winello` script by nellokudo automatically checks for updates to its patched Wine build, launcher script, and optional tools before executing most commands. If you need to run a command without triggering these network checks—whether due to metered connections, avoiding lengthy downloads, or troubleshooting—you can use the **`n` prefix** to skip all update logic.

## What Is the `n` Prefix in osu-winello?

The `n` prefix is a single-letter argument modifier that instructs the launcher to skip its internal `Update()` routine. When the script parses arguments and detects a leading `n`, it strips this character and sets the `NOLAUNCHERUPDATE` environment flag. This flag signals the update mechanism to exit early without contacting remote servers or downloading new components.

According to the source code documentation in [`osu-winello.sh`](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh):

> "NOTE: Any command can be prefixed by the letter `n` to avoid updating when running it."
> — [osu-winello.sh, lines 73–76](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh#L73-L76)

## How the `n` Prefix Works Under the Hood

The implementation resides in the main launcher script [`osu-winello.sh`](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh). The script examines the first argument using pattern matching to detect the `n` prefix:

```bash

# Pattern matching logic (simplified from source)

if [[ "$1" =~ ^n$|^n- ]]; then
    export NOLAUNCHERUPDATE=1
    # Remove the leading 'n' from the argument

    set -- "${1#n}" "${@:2}"
fi

```

### The Update() Function Logic

Later in the execution flow, the `Update()` function checks for the `NOLAUNCHERUPDATE` flag before proceeding with network operations:

```bash
Update() {
    [ -n "$NOLAUNCHERUPDATE" ] && Info "Your osu-wine launcher will be left alone." && return 0
    
    # Normal update logic follows...

    # Checks for new Wine-osu versions, launcher updates, etc.

}

```

This early return mechanism ensures that when `NOLAUNCHERUPDATE` is set, the script bypasses both the launcher self-update and the Wine-osu update steps while continuing to process the requested command normally.

## Practical Examples of Using the `n` Prefix

The `n` prefix works with any sub-command supported by `osu-winello`. Place the `n` immediately before the first flag or command argument.

### Skip Updates During Maintenance Commands

```bash

# Normal behavior: checks for updates before fixing the Wine prefix

osu-wine --fixprefix

# Skip all update checks

osu-wine n --fixprefix

```

### Launch osu! Without Network Checks

```bash

# Run the game immediately without checking for Wine or launcher updates

osu-wine n

```

### Update Specific Components Only

```bash

# Update the launcher and Wine normally

osu-wine --update

# Check yawl wrapper without updating the launcher

osu-wine n --fixyawl

```

### Run Custom Executables in the Prefix

```bash

# Launch a custom tool inside the Wine prefix without update delays

osu-wine n --runinprefix mytool.exe

```

When combining multiple flags, place `n` only before the first argument:

```bash

# Correct: n precedes the first flag

osu-wine n --fixprefix --some-other-option

# Incorrect: n in the middle

osu-wine --fixprefix n --some-other-option

```

## When to Skip Updates with the `n` Prefix

Use the `n` prefix in the following scenarios:

- **Metered connections**: Avoid downloading large Wine binaries or launcher updates on limited bandwidth connections.
- **Troubleshooting**: Isolate whether an issue stems from recent updates by running commands with the current installed versions.
- **Speed**: Execute maintenance commands immediately without waiting for network timeout checks or download verification.
- **Offline usage**: Run osu-winello commands when no internet connection is available, provided all components are already cached.

## Summary

- **Prepend `n`** to any `osu-winello` command to skip automatic update checks for the launcher script and Wine components.
- The feature sets the internal `NOLAUNCHERUPDATE` flag in [`osu-winello.sh`](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh), causing the `Update()` function to return early without network operations.
- This works with all sub-commands including `--fixprefix`, `--fixyawl`, `--update`, and `--runinprefix`.
- Documented in the source at [osu-winello.sh lines 73–76](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh#L73-L76) and implemented in the `Update()` function.

## Frequently Asked Questions

### Can I use the `n` prefix with any osu-winello command?

Yes. According to the source code comment in [`osu-winello.sh`](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh), any command can be prefixed with the letter `n` to avoid updating when running it. This includes game launch, maintenance flags like `--fixprefix`, and utility commands like `--runinprefix`.

### Does the `n` prefix skip Wine prefix updates or just launcher updates?

The `n` prefix skips both the launcher self-update and the Wine-osu update steps. When `NOLAUNCHERUPDATE` is set, the `Update()` function exits immediately before checking either component, though the rest of your command (such as `--fixprefix`) still executes using the currently installed versions.

### Where is the `n` prefix documented in the source code?

The feature is explicitly documented in [`osu-winello.sh`](https://github.com/nellokudo/osu-winello/blob/main/osu-winello.sh) at lines 73–76 with the comment: "NOTE: Any command can be prefixed by the letter `n` to avoid updating when running it." The implementation logic resides in the argument parsing section and the `Update()` function within the same file.

### Can I combine the `n` prefix with multiple flags?

Yes, but you must place `n` immediately before the first flag or argument. For example, `osu-wine n --fixprefix --some-other-option` works correctly, while placing `n` in the middle of the argument list will not trigger the skip-update behavior. The script only checks the first argument for the `n` prefix pattern.