ytclip


Nameytclip JSON
Version 1.2.7 PyPI version JSON
download
home_pagehttps://github.com/zackees/ytclip
SummaryCommand to download a video and cut out a clip.
upload_time2024-02-14 23:42:15
maintainer
docs_urlNone
authorZach Vorhies
requires_python>=3.6.0
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ytclip - Quickly clip any video you see online and save it to your harddrive

# Usage

Make sure python (>3.7) is installed on your system.

```bash
> pip install ytclip
> ytclip https://www.youtube.com/watch?v=dQw4w9WgXcQ
# Follow the prompts
```

[![Actions Status](https://github.com/zackees/ytclip/workflows/MacOS_Tests/badge.svg)](https://github.com/zackees/ytclip/actions/workflows/push_macos.yml)
[![Actions Status](https://github.com/zackees/ytclip/workflows/Win_Tests/badge.svg)](https://github.com/zackees/ytclip/actions/workflows/push_win.yml)
[![Actions Status](https://github.com/zackees/ytclip/workflows/Ubuntu_Tests/badge.svg)](https://github.com/zackees/ytclip/actions/workflows/push_ubuntu.yml)

# About

This utility provides a command that will automate downloading files and creating clips out of them.

Uses `yt-dlp` to do the downloading of files and uses `static_ffmpeg` to do the actual cutting.

### Windows

For easy use, just download the [`run_ytclip.bat`](https://raw.githubusercontent.com/zackees/ytclip/main/run_ytclip.bat) file and place it into any folder you want. Now you have a double clickable icon for users that don't like going to the command line. Make sure you've installed the [latest python](https://python.org/download), checking the box that says "ADD TO PATH" during installation.

# Running


```bash
# (Interactive)
> cd <MY_DIRECTORY>
> ytclip
Add new video:
  url: ...
  start_timestamp: 08:08
  end_timestamp: 08:20
  output_name: my_file
```

```bash
# (CMD-line)
> cd <MY_DIRECTORY>
> ytclip https://www.youtube.com/watch?v=CLXt3yh2g0s --start_timestamp 00:32 --end_timestamp 00:52 --outname myoutputfile
```

```bash
# Help file
> ytclip --help
```


# Api

You can also use it as an api:

```python
from ytclip.ytclip import run_download_and_cut

run_download_and_cut(
    url="https://www.youtube.com/watch?v=-wtIMTCHWuI",
    start_timestamp="1:10",
    end_timestamp="1:30",
    outname="myclip_withoutsuffix")
```

You can also turn off logging like so:

```python
from ytclip.ytclip import run_download_and_cut, set_logging

set_logging(False)
run_download_and_cut(...)
```

# Server

See the server version: [ytclip-server](https://github.com/zackees/ytclip-server)

# Releases

  * 1.2.7: Brighteon downloads have been fixed, thanks to the brighteon plugin.
  * 1.2.6: Fix error where omitting length would cause error.
  * 1.2.5: Cleans youtube videos by removing the ?t= part of the url.
  * 1.2.4: Adds update warning for ytclip if out of date.
  * 1.2.3: Make yt-dlp use 1.2.3 or higher (fixes downloader).

# TODO

  * Add lossless cut to tool:
    * https://github.com/mifi/lossless-cut

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/zackees/ytclip",
    "name": "ytclip",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6.0",
    "maintainer_email": "",
    "keywords": "",
    "author": "Zach Vorhies",
    "author_email": "dont@email.me",
    "download_url": "https://files.pythonhosted.org/packages/97/b2/933a45d3ef9f48d482463ea33819fe9323ec3da5ff5206578c2649d46ce6/ytclip-1.2.7.tar.gz",
    "platform": null,
    "description": "# ytclip - Quickly clip any video you see online and save it to your harddrive\r\n\r\n# Usage\r\n\r\nMake sure python (>3.7) is installed on your system.\r\n\r\n```bash\r\n> pip install ytclip\r\n> ytclip https://www.youtube.com/watch?v=dQw4w9WgXcQ\r\n# Follow the prompts\r\n```\r\n\r\n[![Actions Status](https://github.com/zackees/ytclip/workflows/MacOS_Tests/badge.svg)](https://github.com/zackees/ytclip/actions/workflows/push_macos.yml)\r\n[![Actions Status](https://github.com/zackees/ytclip/workflows/Win_Tests/badge.svg)](https://github.com/zackees/ytclip/actions/workflows/push_win.yml)\r\n[![Actions Status](https://github.com/zackees/ytclip/workflows/Ubuntu_Tests/badge.svg)](https://github.com/zackees/ytclip/actions/workflows/push_ubuntu.yml)\r\n\r\n# About\r\n\r\nThis utility provides a command that will automate downloading files and creating clips out of them.\r\n\r\nUses `yt-dlp` to do the downloading of files and uses `static_ffmpeg` to do the actual cutting.\r\n\r\n### Windows\r\n\r\nFor easy use, just download the [`run_ytclip.bat`](https://raw.githubusercontent.com/zackees/ytclip/main/run_ytclip.bat) file and place it into any folder you want. Now you have a double clickable icon for users that don't like going to the command line. Make sure you've installed the [latest python](https://python.org/download), checking the box that says \"ADD TO PATH\" during installation.\r\n\r\n# Running\r\n\r\n\r\n```bash\r\n# (Interactive)\r\n> cd <MY_DIRECTORY>\r\n> ytclip\r\nAdd new video:\r\n  url: ...\r\n  start_timestamp: 08:08\r\n  end_timestamp: 08:20\r\n  output_name: my_file\r\n```\r\n\r\n```bash\r\n# (CMD-line)\r\n> cd <MY_DIRECTORY>\r\n> ytclip https://www.youtube.com/watch?v=CLXt3yh2g0s --start_timestamp 00:32 --end_timestamp 00:52 --outname myoutputfile\r\n```\r\n\r\n```bash\r\n# Help file\r\n> ytclip --help\r\n```\r\n\r\n\r\n# Api\r\n\r\nYou can also use it as an api:\r\n\r\n```python\r\nfrom ytclip.ytclip import run_download_and_cut\r\n\r\nrun_download_and_cut(\r\n    url=\"https://www.youtube.com/watch?v=-wtIMTCHWuI\",\r\n    start_timestamp=\"1:10\",\r\n    end_timestamp=\"1:30\",\r\n    outname=\"myclip_withoutsuffix\")\r\n```\r\n\r\nYou can also turn off logging like so:\r\n\r\n```python\r\nfrom ytclip.ytclip import run_download_and_cut, set_logging\r\n\r\nset_logging(False)\r\nrun_download_and_cut(...)\r\n```\r\n\r\n# Server\r\n\r\nSee the server version: [ytclip-server](https://github.com/zackees/ytclip-server)\r\n\r\n# Releases\r\n\r\n  * 1.2.7: Brighteon downloads have been fixed, thanks to the brighteon plugin.\r\n  * 1.2.6: Fix error where omitting length would cause error.\r\n  * 1.2.5: Cleans youtube videos by removing the ?t= part of the url.\r\n  * 1.2.4: Adds update warning for ytclip if out of date.\r\n  * 1.2.3: Make yt-dlp use 1.2.3 or higher (fixes downloader).\r\n\r\n# TODO\r\n\r\n  * Add lossless cut to tool:\r\n    * https://github.com/mifi/lossless-cut\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Command to download a video and cut out a clip.",
    "version": "1.2.7",
    "project_urls": {
        "Homepage": "https://github.com/zackees/ytclip"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "31c2fd490123fc5bbf901e56b3817da9d2a4e0362ac4dda44ded46bd6f3160c1",
                "md5": "4a5a6805047aed717618a69620fa9deb",
                "sha256": "1399c9e4e7c180c5949e05404f7fc704a6a6a75f4633909b1522e31daa8f42f5"
            },
            "downloads": -1,
            "filename": "ytclip-1.2.7-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4a5a6805047aed717618a69620fa9deb",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.6.0",
            "size": 8894,
            "upload_time": "2024-02-14T23:42:14",
            "upload_time_iso_8601": "2024-02-14T23:42:14.772357Z",
            "url": "https://files.pythonhosted.org/packages/31/c2/fd490123fc5bbf901e56b3817da9d2a4e0362ac4dda44ded46bd6f3160c1/ytclip-1.2.7-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "97b2933a45d3ef9f48d482463ea33819fe9323ec3da5ff5206578c2649d46ce6",
                "md5": "8246c2d92ff7f4218116d7fa7143437d",
                "sha256": "9d8fa8448aa7c7f1c7ea0735e2561d037e237903d62d4ee95a64b59ce9994dc2"
            },
            "downloads": -1,
            "filename": "ytclip-1.2.7.tar.gz",
            "has_sig": false,
            "md5_digest": "8246c2d92ff7f4218116d7fa7143437d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6.0",
            "size": 10291,
            "upload_time": "2024-02-14T23:42:15",
            "upload_time_iso_8601": "2024-02-14T23:42:15.973263Z",
            "url": "https://files.pythonhosted.org/packages/97/b2/933a45d3ef9f48d482463ea33819fe9323ec3da5ff5206578c2649d46ce6/ytclip-1.2.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-14 23:42:15",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "zackees",
    "github_project": "ytclip",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "ytclip"
}
        
Elapsed time: 0.18334s