If you're upgrading from v2 to v3, please delete your old history and configuration file as they might cause the script to break. That can be done with
rm ~/.cache/lobster_history.txt && rm ~/.config/lobster/lobster_config.txt
sudo curl -sL github.com/justchokingaround/lobster/raw/main/lobster.sh -o /usr/local/bin/lobster &&
sudo chmod +x /usr/local/bin/lobster
curl -sL github.com/justchokingaround/lobster/raw/main/lobster.sh -o "$(brew --prefix)"/bin/lobster &&
chmod +x "$(brew --prefix)"/bin/lobster
- Install scoop
Open a PowerShell terminal https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.2#msi (version 5.1 or later) and run:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
- Install git,mpv and fzf
scoop bucket add extras
scoop install git mpv fzf
-
Install git bash https://git-scm.com/download/win
-
Install windows terminal (you don't need to have a microsoft account for that) https://learn.microsoft.com/en-us/windows/terminal/install
-
Adding git bash to windows terminal.
a) Install windows terminal from the Microsoft store.
b) Open the terminal.
c) Open settings.
d) Click "Add a new profile"
e) Click "New empty profile"
f) Click on "name" and rename it to "Git Bash"
g) Click on "Command line" and click "Browse..."
h) If you installed git using scoop then follow this(else the steps are mostly the same just a different path) navigate to
C:\User\USERNAME\scoop\apps\git\2.37.1.windows.1\bin\bash.exe
Where USERNAME is your username note that the name2.37.1.windows.1
might be slightly different on your systemj) Click "Open"
k) Click "Starting directory" and uncheck "Use parent process directory"
l) Click "Save"
m) Now you can open gitbash from the windows terminal
-
Clone the repo and go inside it
git clone https://github.com/justchokingaround/lobster && cd lobster
- Add the script to default path for binaries
cp lobster.sh /usr/bin/lobster
- Denote permission to access the file in executable mode
sudo chmod +x /usr/bin/lobster
- Use lobster (either with git bash or windows terminal)
lobster <args> or lobster [movie/tv show]
pkg up -y && pkg install fzf
curl -sL github.com/justchokingaround/lobster/raw/main/lobster.sh -o "$PREFIX"/bin/lobster
chmod +x "$PREFIX"/bin/lobster
Settings are stored in ~/.config/lobster/lobster_config.txt
. The file is created on first launch with the default options and looks like this
player=mpv
subs_language=English
video_quality=1080
preferred_server=vidcloud
There are 3 available video players to chose from : mpv
, iina
or vlc
.
The subs_language
setting can be any language, e.g. English
, French
, German
, Spanish
and so on. Please note that not all streams have subtitles in every language, so English
is the safest option. It is also important to capitalize the first letter of the language, otherwise it might trigger unexpected behavior.
The video_quality
setting can be set to either 1080
, 720
, 360
or auto
. auto
will select the best quality depending on your bandwith
The preferred_server
setting can be either vidcloud
or upcloud
.
- If any of the above settings is wrong, e.g. if
video_quality
is set to a value like 480, the script will fail with aNo links found
message and nothing will be played. However, if the subs_language is set to a language that is not available, the script will just show aNo subtitles found
message but will play the stream.
In a similar fashion to how saving your position when you watch videos on YouTube or Netflix, lobster has history support and saves the last minute you watched for a movie or tv show. To use this feature, simply watch a movie or an episode from a tv show, and after you quit mpv press Enter to save the position (there will be a prompt telling you to do that). The next time you want to resume from the last position watched, you can just run
lobster -c
which will prompt you to chose which of the saved movies/tv shows you'd like to resume from.
- If there is only one entry in the history file, it'll be automatically selected
- The history file can be found at
~/.config/lobster_history.txt
- A movie or TV show episode is automatically marked as completed/updated after the user watches more than 85% of its content*
-c, continue from history (saves the your progress in minutes)
-d, delete history
-u, -U update script
-v, -V show script version
-h show help
- fzf
- curl
- grep
- sed
- patch
- mpv
- vlc (optional)
- iina (optional)
- android vlc & mpv (optional)
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install
sudo rm /usr/local/bin/lobster
rm "$(brew --prefix)"/bin/lobster
rm /usr/bin/lobster