| Name | karaoke-lyrics-processor JSON |
| Version |
0.4.2
JSON |
| download |
| home_page | None |
| Summary | Process song lyrics to prepare them for karaoke video production, e.g. by splitting long lines |
| upload_time | 2025-02-06 06:09:19 |
| maintainer | None |
| docs_url | None |
| author | Andrew Beveridge |
| requires_python | <3.13,>=3.9 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Karaoke Lyrics Processor 🎶 ✍️
Karaoke Lyrics Processor is a tool to prepare song lyrics for karaoke video production.
It processes lyrics by splitting long lines, handling parentheses, and ensuring that each line fits within a specified maximum length.
This tool is especially useful for creating karaoke tracks where timing and line length are crucial for readability.
## Features
- **Line Splitting**: Automatically splits long lines of lyrics to ensure they fit within a specified maximum length, making them more readable and suitable for karaoke display.
- **Intelligent Splitting**: Finds the best split points in lines, considering punctuation and logical breaks in the lyrics.
- **Parentheses Handling**: Processes lines containing parentheses appropriately, ensuring that the lyrical flow is maintained.
- **Clipboard Support**: Copies the processed lyrics to the clipboard for easy pasting into video production software or other applications.
- **Debug Mode**: Offers a debug mode for detailed logging, helping with troubleshooting and fine-tuning the processing.
## Installation
To install the Karaoke Lyrics Processor, ensure you have Python 3.9 or newer in your environment.
This package is available on PyPI and can be installed using pip. Run the following command in your terminal:
```bash
pip install karaoke-lyrics-processor
```
## Usage (CLI)
To process a file containing song lyrics, use the following command:
```bash
karaoke-lyrics-processor <path_to_lyrics_file>
```
By default, this will create a new file in your current directory with `(Lyrics Processed)` in the filename containing the processed lyrics.
### Command line options
```bash
usage: karaoke-lyrics-processor [-h] [-v] [-d] [-o OUTPUT] [-l LINE_LENGTH] filename
Process song lyrics to prepare them for karaoke video production, e.g. by splitting long lines
positional arguments:
filename The path to the file containing the song lyrics to process.
options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-d, --debug Enable debug mode, setting log level to DEBUG.
-o OUTPUT, --output OUTPUT Optional: Specify the output filename for the processed lyrics.
-l LINE_LENGTH, --line_length LINE_LENGTH Optional: Specify the maximum line length for the processed lyrics. Default is 36.
```
## Contributing 🤝
Contributions are very much welcome! Please fork the repository and submit a pull request with your changes, and I'll try to review, merge and publish promptly!
- This project is 100% open-source and free for anyone to use and modify as they wish.
- If the maintenance workload for this repo somehow becomes too much for me I'll ask for volunteers to share maintainership of the repo, though I don't think that is very likely
## License 📄
This project is licensed under the MIT [License](LICENSE).
## Contact 💌
For questions or feedback, please raise an issue or reach out to @beveradb ([Andrew Beveridge](mailto:andrew@beveridge.uk)) directly.
Raw data
{
"_id": null,
"home_page": null,
"name": "karaoke-lyrics-processor",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Andrew Beveridge",
"author_email": "andrew@beveridge.uk",
"download_url": "https://files.pythonhosted.org/packages/a4/d7/086474a6e004199fe91384c68515a7003e2efab35d8e264207c711fe2d87/karaoke_lyrics_processor-0.4.2.tar.gz",
"platform": null,
"description": "# Karaoke Lyrics Processor \ud83c\udfb6 \u270d\ufe0f\n\n\n\nKaraoke Lyrics Processor is a tool to prepare song lyrics for karaoke video production. \n\nIt processes lyrics by splitting long lines, handling parentheses, and ensuring that each line fits within a specified maximum length. \nThis tool is especially useful for creating karaoke tracks where timing and line length are crucial for readability.\n\n## Features\n\n- **Line Splitting**: Automatically splits long lines of lyrics to ensure they fit within a specified maximum length, making them more readable and suitable for karaoke display.\n- **Intelligent Splitting**: Finds the best split points in lines, considering punctuation and logical breaks in the lyrics.\n- **Parentheses Handling**: Processes lines containing parentheses appropriately, ensuring that the lyrical flow is maintained.\n- **Clipboard Support**: Copies the processed lyrics to the clipboard for easy pasting into video production software or other applications.\n- **Debug Mode**: Offers a debug mode for detailed logging, helping with troubleshooting and fine-tuning the processing.\n\n## Installation\n\nTo install the Karaoke Lyrics Processor, ensure you have Python 3.9 or newer in your environment. \n\nThis package is available on PyPI and can be installed using pip. Run the following command in your terminal:\n\n```bash\npip install karaoke-lyrics-processor\n```\n\n## Usage (CLI)\n\nTo process a file containing song lyrics, use the following command:\n\n```bash\nkaraoke-lyrics-processor <path_to_lyrics_file>\n```\n\nBy default, this will create a new file in your current directory with `(Lyrics Processed)` in the filename containing the processed lyrics.\n\n### Command line options\n\n```bash\nusage: karaoke-lyrics-processor [-h] [-v] [-d] [-o OUTPUT] [-l LINE_LENGTH] filename\n\nProcess song lyrics to prepare them for karaoke video production, e.g. by splitting long lines\n\npositional arguments:\n filename The path to the file containing the song lyrics to process.\n\noptions:\n -h, --help show this help message and exit\n -v, --version show program's version number and exit\n -d, --debug Enable debug mode, setting log level to DEBUG.\n -o OUTPUT, --output OUTPUT Optional: Specify the output filename for the processed lyrics.\n -l LINE_LENGTH, --line_length LINE_LENGTH Optional: Specify the maximum line length for the processed lyrics. Default is 36.\n```\n\n## Contributing \ud83e\udd1d\n\nContributions are very much welcome! Please fork the repository and submit a pull request with your changes, and I'll try to review, merge and publish promptly!\n\n- This project is 100% open-source and free for anyone to use and modify as they wish. \n- If the maintenance workload for this repo somehow becomes too much for me I'll ask for volunteers to share maintainership of the repo, though I don't think that is very likely\n\n## License \ud83d\udcc4\n\nThis project is licensed under the MIT [License](LICENSE).\n\n## Contact \ud83d\udc8c\n\nFor questions or feedback, please raise an issue or reach out to @beveradb ([Andrew Beveridge](mailto:andrew@beveridge.uk)) directly.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Process song lyrics to prepare them for karaoke video production, e.g. by splitting long lines",
"version": "0.4.2",
"project_urls": {
"Documentation": "https://github.com/karaokenerds/karaoke-lyrics-processor/blob/main/README.md",
"Homepage": "https://github.com/karaokenerds/karaoke-lyrics-processor",
"Repository": "https://github.com/karaokenerds/karaoke-lyrics-processor"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "57808d0c942e775c04a077e1cfd492f7e0b997f473a4124c84b9220dc96a830e",
"md5": "bbb49298a373f9a26274106893404def",
"sha256": "e77854504d1ca932933be156c4e8ca444dc7587f48d01b6e4506968cc93a6e7c"
},
"downloads": -1,
"filename": "karaoke_lyrics_processor-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bbb49298a373f9a26274106893404def",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 8919,
"upload_time": "2025-02-06T06:09:17",
"upload_time_iso_8601": "2025-02-06T06:09:17.658414Z",
"url": "https://files.pythonhosted.org/packages/57/80/8d0c942e775c04a077e1cfd492f7e0b997f473a4124c84b9220dc96a830e/karaoke_lyrics_processor-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a4d7086474a6e004199fe91384c68515a7003e2efab35d8e264207c711fe2d87",
"md5": "5ef44d802393bf00a06c847155ab7385",
"sha256": "134be4472853231835e1eb9da806997355b0dc7dcd39c85d45d0bb61e5d04ee0"
},
"downloads": -1,
"filename": "karaoke_lyrics_processor-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "5ef44d802393bf00a06c847155ab7385",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 7218,
"upload_time": "2025-02-06T06:09:19",
"upload_time_iso_8601": "2025-02-06T06:09:19.884523Z",
"url": "https://files.pythonhosted.org/packages/a4/d7/086474a6e004199fe91384c68515a7003e2efab35d8e264207c711fe2d87/karaoke_lyrics_processor-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-06 06:09:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "karaokenerds",
"github_project": "karaoke-lyrics-processor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "karaoke-lyrics-processor"
}
