{"id":26686931,"url":"https://github.com/timeless-residents/handson-blender-scripts","last_synced_at":"2026-05-05T05:41:23.194Z","repository":{"id":275695753,"uuid":"926869386","full_name":"timeless-residents/handson-blender-scripts","owner":"timeless-residents","description":"Collection of Python scripts demonstrating Blender automation for 3D modeling and rendering. Each script showcases different techniques with visual outputs.","archived":false,"fork":false,"pushed_at":"2025-02-20T22:05:11.000Z","size":14992,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-20T23:19:44.067Z","etag":null,"topics":["3d","3d-graphics","automation","blender","blender-python","computer-graphics","learning-resources","python","rendering","scripting","tutorial"],"latest_commit_sha":null,"homepage":"https://timeless-residents.github.io/handson-blender-scripts/","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/timeless-residents.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-02-04T01:56:52.000Z","updated_at":"2025-02-20T22:05:14.000Z","dependencies_parsed_at":"2025-02-20T23:29:28.691Z","dependency_job_id":null,"html_url":"https://github.com/timeless-residents/handson-blender-scripts","commit_stats":null,"previous_names":["timeless-residents/handson-blender-scripts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeless-residents%2Fhandson-blender-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeless-residents%2Fhandson-blender-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeless-residents%2Fhandson-blender-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timeless-residents%2Fhandson-blender-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timeless-residents","download_url":"https://codeload.github.com/timeless-residents/handson-blender-scripts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245650477,"owners_count":20650105,"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":["3d","3d-graphics","automation","blender","blender-python","computer-graphics","learning-resources","python","rendering","scripting","tutorial"],"created_at":"2025-03-26T12:15:19.112Z","updated_at":"2026-05-05T05:41:23.143Z","avatar_url":"https://github.com/timeless-residents.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blender Python スクリプト開発環境セットアップガイド\n\nこのリポジトリではBlenderのPythonスクリプト開発環境のセットアップ方法を説明します。\n\n## 前提条件\n\n- macOS\n- Blenderがインストールされていること\n- VS Code（オプション：より良い開発体験のため）\n\n## Blenderのコマンドライン実行\n\n### 基本的な起動方法\n\n```bash\n/Applications/Blender.app/Contents/MacOS/Blender\n```\n\n### Pythonスクリプトを実行する場合\n\n```bash\n/Applications/Blender.app/Contents/MacOS/Blender --python your_script.py\n```\n\n### バックグラウンドモード（GUIなし）で実行\n\n```bash\n/Applications/Blender.app/Contents/MacOS/Blender --background\n```\n\n### バックグラウンドでPythonスクリプトを実行（推奨）\n\n```bash\n/Applications/Blender.app/Contents/MacOS/Blender --background --python your_script.py\n```\n\n### エイリアスの設定（オプション）\n\n毎回長いパスを入力する手間を省くために、以下のコマンドでエイリアスを設定できます：\n\n```bash\necho 'alias blender=\"/Applications/Blender.app/Contents/MacOS/Blender\"' \u003e\u003e ~/.zshrc\n# または\necho 'alias blender=\"/Applications/Blender.app/Contents/MacOS/Blender\"' \u003e\u003e ~/.bashrc\n```\n\n## VS Code統合\n\nより効率的な開発のために、VS Codeに開発環境を統合することができます。\n\n### 必要な拡張機能\n\n1. \"Blender Development\"\n2. \"Python\"\n\n### VS Code設定\n\n1. `settings.json` に以下を追加：\n\n```json\n{\n    \"blender.executeable\": \"/Applications/Blender.app/Contents/MacOS/Blender\",\n    \"python.analysis.extraPaths\": [\n        \"/Applications/Blender.app/Contents/Resources/4.0/scripts/modules\"\n    ]\n}\n```\n\n2. `.vscode/launch.json` を作成：\n\n```json\n{\n    \"version\": \"0.2.0\",\n    \"configurations\": [\n        {\n            \"name\": \"Blender\",\n            \"type\": \"python\",\n            \"request\": \"launch\",\n            \"program\": \"${file}\",\n            \"python\": \"/Applications/Blender.app/Contents/Resources/4.0/python/bin/python3.10\",\n            \"env\": {\n                \"PYTHONPATH\": \"/Applications/Blender.app/Contents/Resources/4.0/scripts/modules\"\n            }\n        }\n    ]\n}\n```\n\n3. `.vscode/tasks.json` を作成：\n\n```json\n{\n    \"version\": \"2.0.0\",\n    \"tasks\": [\n        {\n            \"label\": \"Run in Blender\",\n            \"type\": \"shell\",\n            \"command\": \"/Applications/Blender.app/Contents/MacOS/Blender --background --python ${file}\",\n            \"group\": {\n                \"kind\": \"build\",\n                \"isDefault\": true\n            }\n        }\n    ]\n}\n```\n\n## スクリプト開発のベストプラクティス\n\nスクリプトの最初に以下のようなインポートチェックを入れることを推奨します：\n\n```python\ntry:\n    import bpy\nexcept ImportError:\n    print(\"このスクリプトはBlenderから実行する必要があります。\")\n    print(\"以下のコマンドを使用してください：\")\n    print(\"/Applications/Blender.app/Contents/MacOS/Blender --background --python script.py\")\n    exit(1)\n```\n\n## 注意事項\n\n- bpyモジュールは直接pipでインストールすることはできません\n- スクリプトは必ずBlenderの実行環境から実行する必要があります\n- パスやバージョン番号は、インストールされているBlenderのバージョンによって異なる場合があります\n\n## キーボードショートカット\n\n- VS Codeでインタープリタを選択: `Command + Shift + P` → \"Python: Select Interpreter\"\n- スクリプトの実行: `Command + Shift + B`（tasks.jsonの設定後）","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimeless-residents%2Fhandson-blender-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimeless-residents%2Fhandson-blender-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimeless-residents%2Fhandson-blender-scripts/lists"}