{"id":27500855,"url":"https://github.com/ppmpreetham/kettle","last_synced_at":"2025-04-17T12:54:21.139Z","repository":{"id":284914795,"uuid":"956463126","full_name":"ppmpreetham/kettle","owner":"ppmpreetham","description":"remotely control blender by executing commands","archived":false,"fork":false,"pushed_at":"2025-03-28T10:05:48.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T11:23:16.919Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ppmpreetham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-03-28T09:48:12.000Z","updated_at":"2025-03-28T10:16:12.000Z","dependencies_parsed_at":"2025-03-28T11:23:18.464Z","dependency_job_id":"dd5a3fcc-e2a3-495b-84df-14822fa82c30","html_url":"https://github.com/ppmpreetham/kettle","commit_stats":null,"previous_names":["ppmpreetham/kettle"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppmpreetham%2Fkettle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppmpreetham%2Fkettle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppmpreetham%2Fkettle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppmpreetham%2Fkettle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ppmpreetham","download_url":"https://codeload.github.com/ppmpreetham/kettle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249342417,"owners_count":21254288,"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":[],"created_at":"2025-04-17T12:54:20.494Z","updated_at":"2025-04-17T12:54:21.132Z","avatar_url":"https://github.com/ppmpreetham.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kettle\nServer to remotely controlling Blender by executing commands in your blender project\n\n## Features\n\n- Send commands to Blender from an external Python script\n- Create basic 3D objects (cubes, spheres) with customizable parameters\n- Execute arbitrary Python code in Blender remotely\n- Delete all objects in a scene\n- Render scenes with custom output paths\n- Interactive command-line interface\n\n## Requirements\n\n- Python 3.6+\n- Blender 2.80+\n\n## Installation\n\n1. Run `kettleaddon.py` as a Python Script in Blender\n2. Run `kettle.py`\n\n## Usage\n\n### As a Module\n\n```python\nfrom kettle import BlenderCommandSender\n\n# Create a sender with default connection to localhost:9999\nsender = BlenderCommandSender()\n\n# Create a cube at coordinates (1, 0, 0) with size 2.0\nsender.create_cube(location=(1, 0, 0), size=2.0)\n\n# Create a sphere at coordinates (0, 1, 0) with radius 1.5\nsender.create_sphere(location=(0, 1, 0), radius=1.5)\n\n# Execute arbitrary Blender Python code\nsender.execute_code(\"bpy.ops.mesh.primitive_monkey_add(location=(0, 0, 2))\")\n\n# Render the scene\nsender.render_scene(filepath=\"/path/to/output.png\")\n\n# Delete all objects\nsender.delete_all()\n\n```\n\n### Interactive Mode\nRun the script directly to enter interactive mode:\n\n```python\npython kettle.py\n```\n\nIn interactive mode, you can type commands like:\n\n```\ncreate_cube 1 0 0 2\ncreate_sphere 0 1 0 1.5\nexecute_code bpy.ops.mesh.primitive_monkey_add(location=(0, 0, 2))\nrender_scene /path/to/output.png\ndelete_all\nhelp\nexit\n```\n\n## Command Reference\n### Basic Commands\n`help` - Display help information about available commands\n`create_cube [x y z] [size]` - Create a cube at specified position with given size\n`create_sphere [x y z] [radius]` - Create a sphere at specified position with given radius\n`delete_all` - Delete all objects in the current scene\n`render_scene [filepath]` - Render the current scene and save it to the specified path\n`exit` - Exit the command sender\n### Advanced Commands\n`execute_code [python_code]` - Execute arbitrary Python code in Blender\n\n## Example Code Snippet\n```python\n# Create a monkey (Suzanne)\nexecute_code bpy.ops.mesh.primitive_monkey_add(location=(0, 0, 2))\n\n# Add a red material to the active object\nexecute_code mat = bpy.data.materials.new(\"RedMaterial\"); mat.diffuse_color = (1, 0, 0, 1); bpy.context.object.data.materials.append(mat)\n\n# Create simple animation\nexecute_code bpy.context.object.location.keyframe_insert(data_path=\"location\", frame=1); bpy.context.object.location = (5, 0, 0); bpy.context.object.location.keyframe_insert(data_path=\"location\", frame=30)\n\n# Set render resolution\nexecute_code bpy.context.scene.render.resolution_x = 1920; bpy.context.scene.render.resolution_y = 1080\n```\n\n## Protocol Details\nCommands are sent as JSON messages with the following structure:\n\n```json\n{\n    \"command\": \"command_name\",\n    \"params\": {\n        \"param1\": value1,\n        \"param2\": value2\n    },\n    \"timestamp\": \"YYYY-MM-DD HH:MM:SS\",\n    \"user\": \"username\"\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppmpreetham%2Fkettle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fppmpreetham%2Fkettle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppmpreetham%2Fkettle/lists"}