cargo-skyline

A cargo subcommand for making it easier to work with (and make) Skyline plugins.

cargo-skyline 1.13.0

USAGE:
    cargo skyline <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    build          Build the current plugin as an NRO
    help           Prints this message or the help of the given subcommand(s)
    install        Build the current plugin and install to a switch over FTP
    list           List the files in the plugin directory for the given game
    listen         Listen for logs being output from a switch running skyline at the given ip
    new            Create a new plugin from a template
    package        Package plugin and latest Skyline into a zip file to prepare it for release
    rm             Delete a file from the plugin directory for the given game
    run            Install the current plugin and listen for skyline logging
    self-update    Update cargo-skyline command
    set-ip         Set the IP address of the switch to install to
    show-ip        Show the currently configured IP address
    update         Update libraries for current plugin folder
    update-std     Download the latest stdlib for aarch64-skyline-switch

Prerequisites

• Rust
• git

Installation

cargo install cargo-skyline

Example usage

Create a new plugin called fps_counter (in a folder of the same name) in the current directory:

cargo skyline new fps_counter

Build the current plugin as an nro:

cargo skyline build

Set the ip of the Switch to install to as 192.168.0.0:

cargo skyline set-ip 192.168.0.0

Install the current plugin on a switch at ip 192.168.0.0 for an application with title of 01006A800016E000:

cargo skyline install --ip 192.168.0.0 --title-id 01006A800016E000

Note: if the IP has been set, it can be omitted from the arguments (or overriden using the arguments).

To set a default title id for a plugin use the following format in Cargo.toml:

[package.metadata.skyline]
titleid = "01006A800016E000"

Install the current plugin to the default IP and title ID, then listen for output from the console:

cargo skyline run

Alternative Installation via Docker

docker build -t cargo-skyline .
docker run it cargo-skyline cargo skyline --help