Skip to content

Command line tool for watching GOMtv streams on Linux and OSX systems. Based on the prior work of Tomas Herman but updated to work on newer seasons' streams.

Notifications You must be signed in to change notification settings

carlosm/GOMstreamer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GOMstreamer Readme

Introduction

GOMstreamer is a Python utility allowing OSX and other Unix based OS users to watch and save GOMtv GSL streams. Note, you are able to watch the streams in VLC as they are downloading, though this will require another instance of VLC to be loaded.

Requirements

  • Python 2.7.x with following libraries:
    • urllib2
    • cookielib
    • urllib
    • re
    • os
    • optparse
    • datetime
    • time
  • VLC
  • wget (for Linux users) or curl (for OSX users)

Usage

Standard Usage

If you are an OSX user, browse the mac folder and enter your GOMtv email and password into the play.command script, then execute it by double-clicking it. To save a stream, do the same but for the save.command script. In order to record a stream at a specific time, edit scheduled-save.command and as was the case with previous scripts, enter in your user credentials. On top of this you must enter a Korean time (24h format) at which to save the stream, by default this is set to 18:00.

For Windows users, the same instructions as above apply. The only differences being that the files are located in the win folder, and they have a cmd file extension.

For Linux users, edit the files located in the linux directory: play.sh, save.sh and scheduled-save.sh. Execute the appropriate script via the terminal. To play the stream that GOMstreamer dumped, open the file (default = dump.ogm) in any decent media player, like VLC.

GOMstreamer parameters

-h, --help show this help message and exit -p PASSWORD, --password=PASSWORD Password to your GOMtv account -e EMAIL, --email=EMAIL Email your GOMtv account uses -m MODE, --mode=MODE Mode of use: "play", "save" or "scheduled-save". Default is "play". This parameter is case sensitive. -q QUALITY, --quality=QUALITY Stream quality to use: "HQ", "SQ" or "SQTest". Default is "SQTest". This parameter is case sensitive. -o OUTPUTFILE, --output=OUTPUTFILE File to save stream to (Default = "dump.ogm") -t KT, --time=KT If the "scheduled-save" mode is used, this option holds the value of the *Korean* time to record at in HH:MM format. (Default = "18:00") -v VLCCMD, -c VLCCMD, --vlccmd=VLCCMD, --command=VLCCMD Custom command for playing stream from stdout -w WEBCMD, --webcmd=WEBCMD Custom command for producing stream on stdout -d CACHE, --buffer-time=CACHE VLC cache size in [ms] 

Usage with VLC player

GOMstreamer uses VLC player by default. In OSX, it requires VLC to be located in the /Applications folder while on other Unix based systems it requires it to be in your shell path (try to type vlc --version in terminal). If the user decides to use the default configuration, all they need to do is specify email and password via GOMstreamer parameters and the application should take care of the rest.

Security

GOMstreamer requires one's login information in order to retrieve the stream url. This information is sent to the GOMtv website over the insecure HTTP protocol, just like it would be if you logged in via a browser to start up the GOM Player. Therefore the security risk is exactly the same as if one used the 'official' method to start up the stream. The password and login information are ONLY sent to the GOMtv site and are never stored by the script.

The only other network communication that this application does is contact my server to grab a couple of text files. This is so that the tool can check for updates and also to grab the latest GSL season's live URL. This avoids the need to update GOMstreamer each season just to get the correct URL. No user information is sent to the server.

About

Command line tool for watching GOMtv streams on Linux and OSX systems. Based on the prior work of Tomas Herman but updated to work on newer seasons' streams.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 94.2%
  • Shell 5.8%