petit-filou

petit-filou or pf is a command-line tool designed for retrieving videos from wordpress websites. petit-filou features a range of search options, allowing users to finely adjust their search criteria.

Installation

Binary

Download latest release.

Docker

$ docker pull ghcr.io/petit-chat/pf:latest

Build Locally

$ make build

Usage

$ pf --help
Scans WordPress websites to find videos.

Supported MIME types: video/mp4 and video/quicktime (.mov).

Usage: pf [OPTIONS] <URL> <MODE>

Arguments:
  <URL>
          WordPress base URL (e.g. <http://example.com>)

  <MODE>
          Searching mode

          Possible values:
          - fast: Fetch from posts only
          - slow: Fetch from both posts and media

Options:
      --before <BEFORE>
          Result set published before a given date (cf. <https://core.trac.wordpress.org/ticket/41032>)

      --modified-before <MODIFIED_BEFORE>
          Result set modified before a given date (cf. <https://core.trac.wordpress.org/ticket/41032>)

      --after <AFTER>
          Result set published after a given date (cf. <https://core.trac.wordpress.org/ticket/41032>)

      --modified-after <MODIFIED_AFTER>
          Result set modified after a given date (cf. <https://core.trac.wordpress.org/ticket/41032>)

  -e, --exclude <EXCLUDE>
          Ensures result set excludes specific IDs

      --categories-exclude <CATEGORIES_EXCLUDE>
          Ensures result set excludes specific category IDs

      --tags-exclude <TAGS_EXCLUDE>
          Ensures result set excludes to specific tag IDs

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Examples

Retrieve a Maximum of Video URLs

$ pf http://www.example.com slow

Retrieve Video URLs After a Specified Date

$ pf http://www.example.com fast --after 2024-04-06T18:44:41

Retrieve Video URLs Excluding Specific Tags

$ pf http://www.example.com fast --tags-exclude 1 --tags-exclude 2 --tags-exclude 3