Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/monumentality/ifiend

Check latest YouTube uploads without leaving the comfort of your terminal.
https://github.com/monumentality/ifiend

crawler headless-chrome terminal-based youtube yt-dlp

Last synced: 6 days ago
JSON representation

Check latest YouTube uploads without leaving the comfort of your terminal.

Host: GitHub
URL: https://github.com/monumentality/ifiend
Owner: monumentality
License: gpl-3.0
Created: 2024-12-17T13:06:11.000Z (about 1 month ago)
Default Branch: main
Last Pushed: 2024-12-29T19:33:56.000Z (18 days ago)
Last Synced: 2024-12-29T20:21:51.539Z (18 days ago)
Topics: crawler, headless-chrome, terminal-based, youtube, yt-dlp
Language: Rust
Homepage:
Size: 73.2 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# iFiend

Check out the latest videos from your favorite channels in-terminal.

Supports thumbnails in-terminal if you're using [kitty](https://github.com/kovidgoyal/kitty).

![videofetch](https://i.giphy.com/media/v1.Y2lkPTc5MGI3NjExMWN0NGV0dnR0aG9oNjFqanY3bW14dXR5eHc1N2VrbWo5MnhwbzV5MiZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/R3khsJ6oTW8UNu7cmC/giphy.gif)

HTML file generation for those that don't use kitty.

![html](https://i.giphy.com/media/v1.Y2lkPTc5MGI3NjExcmxwam9udXNyM2Z1cHdjbjhld2xvbzRzZWwxdHhqMDN0bno2c3JpcSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/99d0uN46SSZxnSwBlB/giphy.gif)

Select and download videos via [yt-dlp](https://github.com/yt-dlp/yt-dlp) or downloader of your choice.

![download](https://i.giphy.com/media/v1.Y2lkPTc5MGI3NjExMjN6OXJjcGloMWVmZXpuM2xweG9mZXkzcjJrbTAwY2loMHR0OWVrYiZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/UKn0QzT7W1T2LGBpWS/giphy.gif)

# Installation

### Download pre-compiled

1. Navigate to [Releases](https://github.com/monumentality/ifiend/releases) tab and download the latest version.
2. Grant the downloaded binary permission to execute: `chmod +x ifiend`
### Build from source

1. Install the Rust toolchain for your distro.
2. Run `git clone https://github.com/monumentality/ifiend.git` or download and unpack the source code manually.
3. Navigate to the `ifiend` directory.
4. Run `cargo build --release`
5. Wait for ifiend to compile.
6. Now you can run `cargo run --release --` or head straight to `target/release` directory and grab your ifiend executable from there.

# Usage

**Get help:**
```bash
> ifiend
```

**Fetch recent videos from default channels:**
```bash
> ifiend fetch
```

Gets default channels and videos-per-channel from your `config.toml`. Generates the config if you don't already have one. Once generated, you can change it in `~/.config/ifiend/config.toml`

**Fetch [vpc] videos from each channel.**
```bash
> ifiend fetch [vpc]
```
Replace [vpc] with desired number of videos.

**Examples**:

```bash
> ifiend fetch 1
```

**Fetch [vpc] videos from [channel].**
```bash
> ifiend fetch [vpc] [channel] [channel2] [...]
```
Replace [vpc] and [channel] with desired number of videos and channels to get those videos from, respectively.

You can provide multiple channels. You can also provide incomplete channel handles and ifiend will scan your config and try to parse your partial handle into a full one. These are case-sensitive though. For example, if you type `ifiend fetch 1 Oney` and have `@OneyPlays` in your `config.toml` ifiend will understand your argument as `@OneyPlays`.

**Examples:**

Get the 4 latest videos from @hbomberguy.
```bash
> ifiend fetch 4 @hbomberguy
```

Does the same if your `config.toml` has `@hbomberguy` in it.
```bash
> ifiend fetch 4 hbomb
```

Same thing.
```bash
> ifiend fetch 4 guy
```