xypwn / southpark-downloader-ui

Fully self-contained South Park downloader GUI, written in Go for Linux, Windows, MacOS & Android.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

southpark-downloader-ui

Fully self-contained South Park downloader GUI, written in Go for Linux, Windows, MacOS & Android.

If you have any request or criticism in particular, feel free to open an issue (English is preferred, but German is also fine).

Preview image

Running the app

Download

Windows

Open the .exe file.

If it complains about the app being unknown to Microsoft, you can click "More info" -> "Run anyway". The warning should no longer appear after that.

Linux

Extract the archive.

Open a terminal in the extracted directory that contains the Makefile.

Run sudo make install (system-wide) or make user-install (local).

MacOS

Extract the archive.

Run the .app using right click (two fingers), or it will NOT open.

From source (advanced users)

You need to install Golang first

git clone https://github.com/xypwn/southpark-downloader-ui && cd southpark-downloader-ui

go build ./cmd/southpark-downloader-ui

If there's no error message, you should now have an executable binary called southpark-downloader-ui (with a .exe at the end for Windows)

Roadmap

  • Write a custom data binding type using generics (fyne is too restrictive)
    • Use it instead of fyne's bindings
  • Write tests
    • pkg/data
    • pkg/taskqueue
  • Extract GUI components into internal package & despaghettify
    • Individual episodes
    • Downloads
    • Season selection
    • Preferences
  • Extract downloader and cache logic into internal package & despaghettify
    • Make downloads persistent after closing the app
  • Allow directly downloading search results & fix search in general
  • Add 'Download All' button to add all episodes of the season to the queue
  • Make Android usable and useful
    • Figure out a way to save files without direct access to SAF
  • Nitpicks
    • Fix EllipsisLabel text overflow with very large texts
    • Add word breaking for EllipsisLabel

Disclaimer

This application is unofficial and is neither endorsed, nor supported by South Park, Paramount, MTV, Comedy Central, or any associated entities. The application interfaces with official sources using their public APIs in a similar way to a web browser when streaming South Park episodes. Please ensure your usage of this application complies with the terms of service of these APIs.

Downloaded files are intended purely for personal use. Redistribution of these files is considered copyright infringement and is against the law. Users are solely responsible for their use of this application and should not engage in illegal activities.

The application is provided "as is", without warranty of any kind, express or implied, as outlined in the LICENSE. I disclaim all liability and responsibility arising from any reliance placed on the application by its users, or by anyone who may be informed of its contents.

About

Fully self-contained South Park downloader GUI, written in Go for Linux, Windows, MacOS & Android.

License:MIT License


Languages

Language:Go 98.9%Language:Shell 1.1%