castielcleary / osc-dl

Desktop utility for downloading homebrew apps from the Open Shop Channel.

Open Shop Channel DL

OSCDL is a cross platform desktop client for the Open Shop Channel homebrew repository, coded in Python 3.

With OSCDL, you can download hundreds of homebrew apps and themes to your computer or wirelessly send them directly to the Wii.

Installing OSCDL

I recommend using the latest release, as it's a more convenient onefile variation of the program with an installer.

Manual Download:

Make sure Python 3 is installed and used.

1. git clone https://github.com/dhtdht020/osc-dl.git
2. cd osc-dl
3. pip3 install -r requirements_GUI.txt
4. python3 xosc-dl.py

Manual Download of CLI version:

1. git clone https://github.com/dhtdht020/osc-dl.git
2. cd osc-dl
3. pip3 install -r requirements.txt
4. python3 osc_dl.py

CLI Guide:

Important: OSCDL CLI on master is currently being rewritten, and currently has most of its functionality removed or changed.

Please use CLI version 1.2.10 available at https://github.com/dhtdht020/osc-dl/releases/tag/1.2.10

Downloading Homebrew (get command)

You can download homebrew from the Open Shop Channel by using osc-dl get

Example usage: osc-dl get -n wiixplorer

The following arguments can be used

• -n / --name Required. Name of homebrew app to download
• -c / --noconfirm Disable download confirmation message after application metadata displays.
• -o / --output Output file name.

Homebrew Metadata (meta command)

You can obtain visual metadata or metadata items about homebrew applications in the Open Shop Channel by using osc-dl meta

Example usage: osc-dl meta -n wiixplorer

Example output:

=========== Application Metadata ===========
Application: WiiXplorer

Developer: Dimok
Version: r259
Description: Wii File Browser
============================================

Example usage: osc-dl meta -n wiixplorer -t version

Example output:

r259

The following arguments can be used

• -n / --name Required. Name of homebrew app to obtain metadata for.
• -t / --type Type of metadata to obtain (display_name, developer, version, short_description, long_description, release_date, contributors)
• -o / --output Output file name.

List Homebrew (list command)

You can list the names of all homebrew on the Open Shop Channel repository by using osc-dl list

Example usage: osc-dl list

Currently, there are no arguments, although a way to filter the results or save to a file is planned.

Querying Homebrew (query command)

You can search homebrew available on the Open Shop Channel by using osc-dl query

Example usage: osc-dl query -n wiixplorer

This command is unfinished, and can currently only check for exact matches.

The following arguments can be used

• -n / --name Required. Name of homebrew app to query.
• -v / --verify Caused query to return "True" if the app is present and "False" if it isn't.

Download Everything (get-all command)

This command was intended for debugging, and we don't recommend using it, as it might have an unexpected behaviour.

Example usage: osc-dl get-all

This command is not maintained nor supported, and although specified in help, setting output directory is not possible at the time.