Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Pip to Pipx switch #306

Merged
merged 2 commits into from
Sep 19, 2023
Merged

Pip to Pipx switch #306

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
731b2d7
Pip to Pipx switch
vxbinaca Aug 19, 2023
616a21f
Fixed up some things, step 0 to clean previous install method
vxbinaca Aug 22, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 40 additions & 12 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,25 +18,53 @@ Reccomended system specifications:

## Setup and Installation

1. Install `ffmpeg`, pip3 (typically `python3-pip`), and git.
To install ffmpeg in Ubuntu, enable the Universe repository.
0. Uninstall any previous tools from the OS repository or older pip installation methods:

```
sudo apt remove yt-dlp youtube-dl ; pip3 uninstall yt-dlp youtube-dl internetarchive jsonpatch jsondiff jsonpointer mid3cp mid3iconv mid3v2 moggsplit mutagen-inspect mutagen-pony normalizer tdmq tubeup
```

1. Install `ffmpeg`, pip3 (typically `python3-pip`), and `git`.
To install `ffmpeg` in Ubuntu, enable the Universe repository.

For Debian/Ubuntu:

```
sudo apt install ffmpeg python3-pip git
sudo apt install ffmpeg python3-pip git
```

2. Install a Python Virtual Envionment, install PipX, and ensure it's in `$PATH`

```
sudo apt install python3.10-venv
```

You'll need to change the version number of the package based on your installed version of python.

Next you'll need to install `pipx` which sandboxes python apps from the system and makes maintance easier and cleaner

```
sudo pip3 install pipx
```

2. Use pip3 to install the required python3 packages.
Now you'll need to ensure the path of the virtual environment from pipx is in `$PATH`

```
pipx ensurepath
```

Close your shell or terminal and open a new one.

3. Use `pipx` to install the required python3 packages.
At a minimum Python 3.8 and up is required (latest Python preferred).

```
python3 -m pip install -U pip tubeup
pipx install tubeup --include-deps
```

3. If you don't already have an Internet Archive account, [register for one](https://archive.org/account/login.createaccount.php) to give the script upload privileges.
4. If you don't already have an Internet Archive account, [register for one](https://archive.org/account/login.createaccount.php) to give the script upload privileges.

4. Configure `internetarchive` with your Internet Archive account.
5. Configure `internetarchive` with your Internet Archive account.

```
ia configure
Expand All @@ -46,21 +74,21 @@ You will be prompted for your login credentials for the Internet Archive account

Once configured to upload, you're ready to go.

5. Start archiving a video by running the script on a URL (or multiple URLs) [supported by yt-dlp.](https:/yt-dlp/yt-dlp/blob/master/supportedsites.md). For YouTube, this includes account URLs and playlist URLs.
6. Start archiving a video by running the script on a URL (or multiple URLs) [supported by yt-dlp.](https:/yt-dlp/yt-dlp/blob/master/supportedsites.md). For YouTube, this includes account URLs and playlist URLs.

```
tubeup <url>
```

6. Each archived video gets its own Archive.org item. Check out what you've uploaded at
7. Each archived video gets its own Archive.org item. Check out what you've uploaded at

`http://archive.org/details/@yourusername`.


Perodically *before* running, upgrade `tubeup` and its dependencies by running:

```
python3 -m pip install -U tubeup pip
pipx upgrade-all
```


Expand All @@ -74,8 +102,8 @@ Dockerized tubeup is provided by [etnguyen03/docker-tubeup](https:/e
2. Use Windows Terminal by Microsoft to interact with the WSL2 instance.
3. Fully update the Linux installation with your package manager of choice.
```sudo apt update ; sudo apt upgrade```
4. Install python `pip` and `ffmpeg`.
5. Install Tubeup using steps 4-6 in the Linux configuration guide above and configuring `internetarchive` for your Archive.org account.
4. Install python `pip`, and `ffmpeg`.
5. Install Tubeup using steps 2-6 in the Linux configuration guide above and configuring `internetarchive` for your Archive.org account.
6. Periodically update your Linux packages and pip packages.

## Usage
Expand Down
Loading