# Dramasub
A tool for auto-generating visuals for a video based off of an `.ass` subtitle file. Intended for creating visual novel-style visual accompaniments for audio-only content, such as drama CDs.
### Installation and Requirements:
Dramasub can be installed via:
`pip install dramasub`
Requires [FFmpeg](https://ffmpeg.org/) to be installed and for both `ffmpeg` and `ffprobe` configured in PATH. Also requires the [Wand Python bindings](https://docs.wand-py.org/), which requires ImageMagick; please see the Wand documentation for installation instructions.
Has only been tested with Windows, but may work on other platforms.
### Args:
* `-i`, `--input`: Input video file (audio and non-overlay background visuals, such as scene transitions)
* `-o`, `--output`: Output video file
* `-c`, `--config`: Config file (`.py`) that lists what visuals are assigned to each Actor and Effect specified in the .ass subtitle file. For more details, see `examples/example_config.py`.
* `-a`, `-ass`: Input subtitle file (`.ass`). **IMPORTANT: Must be in the current working directory** (path your terminal is in) due to issues with ffmpeg. For an example actor/effect setup, see `examples/example_sub.ass`.
* `--cook_only` (optional): For previewing visuals without processing the whole video. Only reads the `.ass` file and generates accompanying images to the `kitchen` path specified in the config. If set, does not require output video path to be specified, but input video is still required.
Raw data
{
"_id": null,
"home_page": null,
"name": "dramasub",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "drama cd, voice drama, subtitle, .ass, visuals",
"author": "GenericTLAccount",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/61/3f/86bebb58a916cb015ac3f2b6d8b65bb6b8b35a0b7e82e99b43ca97937747/dramasub-0.0.3.tar.gz",
"platform": null,
"description": "# Dramasub\r\n\r\nA tool for auto-generating visuals for a video based off of an `.ass` subtitle file. Intended for creating visual novel-style visual accompaniments for audio-only content, such as drama CDs.\r\n\r\n### Installation and Requirements:\r\n\r\nDramasub can be installed via:\r\n\r\n`pip install dramasub`\r\n\r\nRequires [FFmpeg](https://ffmpeg.org/) to be installed and for both `ffmpeg` and `ffprobe` configured in PATH. Also requires the [Wand Python bindings](https://docs.wand-py.org/), which requires ImageMagick; please see the Wand documentation for installation instructions.\r\n\r\nHas only been tested with Windows, but may work on other platforms.\r\n\r\n\r\n### Args:\r\n* `-i`, `--input`: Input video file (audio and non-overlay background visuals, such as scene transitions)\r\n* `-o`, `--output`: Output video file\r\n* `-c`, `--config`: Config file (`.py`) that lists what visuals are assigned to each Actor and Effect specified in the .ass subtitle file. For more details, see `examples/example_config.py`.\r\n* `-a`, `-ass`: Input subtitle file (`.ass`). **IMPORTANT: Must be in the current working directory** (path your terminal is in) due to issues with ffmpeg. For an example actor/effect setup, see `examples/example_sub.ass`.\r\n* `--cook_only` (optional): For previewing visuals without processing the whole video. Only reads the `.ass` file and generates accompanying images to the `kitchen` path specified in the config. If set, does not require output video path to be specified, but input video is still required.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "script to generate accompanying visuals for voice dramas from .ass subtitle files",
"version": "0.0.3",
"project_urls": {
"Homepage": "https://github.com/GenericTLAccount/dramasub"
},
"split_keywords": [
"drama cd",
" voice drama",
" subtitle",
" .ass",
" visuals"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "67df1332e1209ff3e2e723dd1e372bb7c649cbf6f8cc883e5b10dc828f2ebe44",
"md5": "dc9c492723865456bcd1f24d219f3fb6",
"sha256": "1f87b14029bda5149278bc5778875bfeb82a4c6cb1c131fb23b99ab575c06f7e"
},
"downloads": -1,
"filename": "dramasub-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dc9c492723865456bcd1f24d219f3fb6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 19555,
"upload_time": "2024-05-17T06:43:52",
"upload_time_iso_8601": "2024-05-17T06:43:52.425724Z",
"url": "https://files.pythonhosted.org/packages/67/df/1332e1209ff3e2e723dd1e372bb7c649cbf6f8cc883e5b10dc828f2ebe44/dramasub-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "613f86bebb58a916cb015ac3f2b6d8b65bb6b8b35a0b7e82e99b43ca97937747",
"md5": "1f7bd7a81881b29278bfcf272a3bd059",
"sha256": "c37dd01c7e27cc43eb2e2b51dcbe4e06dfaddf57b3bf9d99e3020487d6355f53"
},
"downloads": -1,
"filename": "dramasub-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "1f7bd7a81881b29278bfcf272a3bd059",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 20146,
"upload_time": "2024-05-17T06:43:53",
"upload_time_iso_8601": "2024-05-17T06:43:53.945362Z",
"url": "https://files.pythonhosted.org/packages/61/3f/86bebb58a916cb015ac3f2b6d8b65bb6b8b35a0b7e82e99b43ca97937747/dramasub-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-17 06:43:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GenericTLAccount",
"github_project": "dramasub",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dramasub"
}
JSON
