{"id":24861433,"url":"https://github.com/deniskropp/storyboard-player","last_synced_at":"2025-04-12T22:44:19.562Z","repository":{"id":275018606,"uuid":"924811618","full_name":"deniskropp/storyboard-player","owner":"deniskropp","description":"Tool to process and visualize storyboard files written in Markdown","archived":false,"fork":false,"pushed_at":"2025-03-03T04:18:48.000Z","size":629,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T17:48:40.964Z","etag":null,"topics":["console-tool","creator-tools","ffmpeg","ffmpeg-script","markdown","md","mp4","player","python","qml","qml-files","qt6","qt6-qml","rendering","story","storyboard","video","video-player"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deniskropp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-30T17:37:12.000Z","updated_at":"2025-03-14T09:36:03.000Z","dependencies_parsed_at":"2025-03-26T16:44:11.630Z","dependency_job_id":"887ac9a0-7040-4a89-8535-70f9c9c5a520","html_url":"https://github.com/deniskropp/storyboard-player","commit_stats":null,"previous_names":["deniskropp/storyboard-player"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deniskropp%2Fstoryboard-player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deniskropp%2Fstoryboard-player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deniskropp%2Fstoryboard-player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deniskropp%2Fstoryboard-player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deniskropp","download_url":"https://codeload.github.com/deniskropp/storyboard-player/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248643048,"owners_count":21138353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["console-tool","creator-tools","ffmpeg","ffmpeg-script","markdown","md","mp4","player","python","qml","qml-files","qt6","qt6-qml","rendering","story","storyboard","video","video-player"],"created_at":"2025-01-31T22:05:15.194Z","updated_at":"2025-04-12T22:44:19.538Z","avatar_url":"https://github.com/deniskropp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Storyboard Player 🎥\n\nThe Storyboard Player is a versatile tool designed to help creators visualize their storytelling ideas through the use of Markdown. Whether you're a filmmaker, game designer, or content creator, this tool streamlines the process of turning your storyboard concepts into actionable visual formats. With support for console display, graphical user interfaces, QML generation, and video rendering, the Storyboard Player enables a seamless storytelling workflow.\n\nhttps://github.com/user-attachments/assets/95b40465-2464-4a57-ac59-146ae5d08689\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n  - [Displaying the Storyboard](#displaying-the-storyboard)\n  - [Generating Files](#generating-files)\n  - [Command Line Arguments](#command-line-arguments)\n\n## Features\n\n- **Markdown Parsing**: Convert markdown files into storyboard scenes.\n- **Image Handling**: Download and convert images to PNG format.\n- **Text-to-Speech**: Generate audio from scene descriptions using the Kokoro TTS pipeline.\n- **Video Rendering**: Render scenes into a single video file.\n- **GUI Display**: Display storyboard scenes in a GUI window.\n- **QML Display**: Generate and display a QML file for interactive storyboard playback.\n\n## Installation\n\n    ```bash\n        pip install storyboard-player\n    ```\n\n## Usage\n\nTo use the Storyboard Player, you can run commands in your terminal. Here are some common functionalities:\n\n### Displaying the Storyboard\n\n**In Console**:\n\n    ```bash\n        storyboard-player test/test-storyboard.md --display\n    ```\n\n**In GUI**:\n\n    ```bash\n        storyboard-player test/test-storyboard.md --display_gui\n    ```\n\n### Generating Files\n\n**QML File**:\n\n    ```bash\n        storyboard-player test/test-storyboard.md --display_qml --qml_output my_player.qml\n    ```\n\n**Render Video**:\n\n    ```bash\n        storyboard-player test/test-storyboard.md --render_video --output my_video.mp4\n    ```\n\n### Command Line Arguments\n\n- `filename`: The path to the storyboard markdown file.\n- `--display`: Display the storyboard in the console.\n- `--display_gui`: Display the storyboard in a GUI window.\n- `--display_qml`: Generate and display the storyboard in a QML viewer.\n- `--render_video`: Render the storyboard to a video file.\n- `--output`: The output video filename (default: `output.mp4`).\n- `--qml_output`: The output QML filename (default: `storyboard.qml`).\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests to improve the Storyboard Player.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeniskropp%2Fstoryboard-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeniskropp%2Fstoryboard-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeniskropp%2Fstoryboard-player/lists"}