# TinyWorld
<div style="text-align:center" align="center">
<img src="https://raw.githubusercontent.com/aaurelions/tinyworld/master/logo.png" width="200">
</div>
**TinyWorld** is a Python library + CLI that generates short, dynamic, colorful videos with:
- **Text & Image** shapes
- **Transitions** (fade in/out, move, rotate, scale)
- **TTS Audio** (powered by Google gTTS)
- **Scene-based** timeline
- **Automatic** final MP4 creation
## Installation
```bash
pip install tinyworld
```
## Usage (CLI)
1. Create a JSON script (e.g. `example.json`) describing your **config**, **tts** text, **scenes**, **shapes**, **transitions**.
2. Run:
```bash
tinyworld example.json
```
This will produce frames, generate TTS audio if present, and create a final MP4 (the default is `tinyworld_output.mp4` or whatever you set in config).
## Demo
```json
{
"config": {
"width": 640,
"height": 360,
"fps": 30,
"bg_color": "white",
"font_path": null,
"font_size": 32,
"output_file": "my_dynamic_video.mp4",
"tts_lang": "en"
},
"tts": "Welcome to the tiny world! Here, shapes and images come to life with simple transitions.",
"scenes": [
{
"duration": 5,
"bg_color": "white",
"shapes": [
{
"type": "text",
"id": "intro_text",
"text": "Hello, TinyWorld!",
"x": 320,
"y": 180
}
],
"transitions": [
{
"name": "FadeIn",
"shape_id": "intro_text",
"start_time": 0,
"end_time": 2
}
]
},
{
"duration": 4,
"bg_color": "white",
"shapes": [
{
"type": "image",
"id": "logo_img",
"image_path": "logo.png",
"x": 200,
"y": 180
}
],
"transitions": [
{
"name": "Move",
"shape_id": "logo_img",
"start_time": 0,
"end_time": 3,
"start_pos": [200, 180],
"end_pos": [440, 180]
},
{
"name": "Rotate",
"shape_id": "logo_img",
"start_time": 1,
"end_time": 4,
"start_angle": 0,
"end_angle": 720
}
]
}
]
}
```
[Watch the demo video](my_dynamic_video.mp4)
## Features
- Scene-by-scene animation
- Easy text or image shapes
- Move, rotate, scale, fade in/out
- TTS to add narration over the video
- JSON-based script means **no coding** needed
- Uses [MoviePy](http://zulko.github.io/moviepy/) to merge frames & audio
Raw data
{
"_id": null,
"home_page": "https://github.com/aaurelions/tinyworld",
"name": "tinyworld",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "video, TTS, audio, visualization",
"author": "A. Aurelions",
"author_email": "\"A. Aurelions\" <aurelions@protonmail.com>",
"download_url": "https://files.pythonhosted.org/packages/37/f4/9a76666cb2b0738b168d2056bf9aad371016e65ebaccc3b16ecd29b79813/tinyworld-0.1.0.tar.gz",
"platform": null,
"description": "# TinyWorld\n\n<div style=\"text-align:center\" align=\"center\">\n <img src=\"https://raw.githubusercontent.com/aaurelions/tinyworld/master/logo.png\" width=\"200\">\n</div>\n\n**TinyWorld** is a Python library + CLI that generates short, dynamic, colorful videos with:\n\n- **Text & Image** shapes\n- **Transitions** (fade in/out, move, rotate, scale)\n- **TTS Audio** (powered by Google gTTS)\n- **Scene-based** timeline\n- **Automatic** final MP4 creation\n\n## Installation\n\n```bash\npip install tinyworld\n```\n\n## Usage (CLI)\n\n1. Create a JSON script (e.g. `example.json`) describing your **config**, **tts** text, **scenes**, **shapes**, **transitions**.\n2. Run:\n\n```bash\ntinyworld example.json\n```\n\nThis will produce frames, generate TTS audio if present, and create a final MP4 (the default is `tinyworld_output.mp4` or whatever you set in config).\n\n## Demo\n\n```json\n{\n \"config\": {\n \"width\": 640,\n \"height\": 360,\n \"fps\": 30,\n \"bg_color\": \"white\",\n \"font_path\": null,\n \"font_size\": 32,\n \"output_file\": \"my_dynamic_video.mp4\",\n \"tts_lang\": \"en\"\n },\n \"tts\": \"Welcome to the tiny world! Here, shapes and images come to life with simple transitions.\",\n \"scenes\": [\n {\n \"duration\": 5,\n \"bg_color\": \"white\",\n \"shapes\": [\n {\n \"type\": \"text\",\n \"id\": \"intro_text\",\n \"text\": \"Hello, TinyWorld!\",\n \"x\": 320,\n \"y\": 180\n }\n ],\n \"transitions\": [\n {\n \"name\": \"FadeIn\",\n \"shape_id\": \"intro_text\",\n \"start_time\": 0,\n \"end_time\": 2\n }\n ]\n },\n {\n \"duration\": 4,\n \"bg_color\": \"white\",\n \"shapes\": [\n {\n \"type\": \"image\",\n \"id\": \"logo_img\",\n \"image_path\": \"logo.png\",\n \"x\": 200,\n \"y\": 180\n }\n ],\n \"transitions\": [\n {\n \"name\": \"Move\",\n \"shape_id\": \"logo_img\",\n \"start_time\": 0,\n \"end_time\": 3,\n \"start_pos\": [200, 180],\n \"end_pos\": [440, 180]\n },\n {\n \"name\": \"Rotate\",\n \"shape_id\": \"logo_img\",\n \"start_time\": 1,\n \"end_time\": 4,\n \"start_angle\": 0,\n \"end_angle\": 720\n }\n ]\n }\n ]\n}\n```\n\n[Watch the demo video](my_dynamic_video.mp4)\n\n## Features\n\n- Scene-by-scene animation\n- Easy text or image shapes\n- Move, rotate, scale, fade in/out\n- TTS to add narration over the video\n- JSON-based script means **no coding** needed\n- Uses [MoviePy](http://zulko.github.io/moviepy/) to merge frames & audio\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A small library to create colorful, dynamic videos with TTS audio",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/aaurelions/tinyworld"
},
"split_keywords": [
"video",
" tts",
" audio",
" visualization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "826e2e569392d253d7b079d477fc71274452832201e260f24c37bf0d6d73eabb",
"md5": "32c35c49e1abdd073adfed68a7ee9e94",
"sha256": "d7380a687dc77f9ca16ba251afc8eab6f4a3074a22897619b5ba7a0d4e3ecc53"
},
"downloads": -1,
"filename": "tinyworld-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "32c35c49e1abdd073adfed68a7ee9e94",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 9402,
"upload_time": "2024-12-26T01:39:19",
"upload_time_iso_8601": "2024-12-26T01:39:19.621740Z",
"url": "https://files.pythonhosted.org/packages/82/6e/2e569392d253d7b079d477fc71274452832201e260f24c37bf0d6d73eabb/tinyworld-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "37f49a76666cb2b0738b168d2056bf9aad371016e65ebaccc3b16ecd29b79813",
"md5": "9c1d6e03d73dadea6eb54edbdfe8a3c1",
"sha256": "19059b725ec08f1a06dcc3e8754bc46dbaa360e0710684ef993936432473e95a"
},
"downloads": -1,
"filename": "tinyworld-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "9c1d6e03d73dadea6eb54edbdfe8a3c1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 8935,
"upload_time": "2024-12-26T01:39:22",
"upload_time_iso_8601": "2024-12-26T01:39:22.226290Z",
"url": "https://files.pythonhosted.org/packages/37/f4/9a76666cb2b0738b168d2056bf9aad371016e65ebaccc3b16ecd29b79813/tinyworld-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-26 01:39:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aaurelions",
"github_project": "tinyworld",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tinyworld"
}
JSON
