{"id":25494092,"url":"https://github.com/ericshantos/hand_control","last_synced_at":"2025-11-09T03:30:28.880Z","repository":{"id":277862252,"uuid":"933491294","full_name":"ericshantos/hand_control","owner":"ericshantos","description":"Computer vision-based remote control","archived":false,"fork":false,"pushed_at":"2025-02-16T16:10:32.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-16T17:26:19.310Z","etag":null,"topics":["computer-vision","mediapipe","opencv-python","python"],"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/ericshantos.png","metadata":{"files":{"readme":"README-pt.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-16T04:42:28.000Z","updated_at":"2025-02-16T16:10:35.000Z","dependencies_parsed_at":"2025-02-16T17:26:28.531Z","dependency_job_id":"d7486c5d-004c-42bc-874c-69e962e8293c","html_url":"https://github.com/ericshantos/hand_control","commit_stats":null,"previous_names":["ericshantos/hand_control"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericshantos%2Fhand_control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericshantos%2Fhand_control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericshantos%2Fhand_control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericshantos%2Fhand_control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ericshantos","download_url":"https://codeload.github.com/ericshantos/hand_control/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239565628,"owners_count":19660159,"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":["computer-vision","mediapipe","opencv-python","python"],"created_at":"2025-02-18T23:19:07.986Z","updated_at":"2025-11-09T03:30:28.841Z","avatar_url":"https://github.com/ericshantos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[🇬🇧] [Read in English](./README.md)\n\n# Controle por Gestos\n\n\u003cdiv\u003e\n\u003cimg src=\"https://img.shields.io/badge/pre--commit-verified-blue?logo=pre-commit\" alt=\"pre-commit habilitado\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Python-3.12-blue?logo=python\" alt=\"python 3.12 utilizado\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Status-Active-success\" alt=\"projeto concluído\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Dependencies-Managed-blue\" alt=\"Dependências gerenciadas\" /\u003e\n\u003c/div\u003e\n\n## Descrição\n\nO projeto **Controle por Gestos** é uma aplicação que permite controlar o volume do sistema e o brilho da tela usando gestos manuais capturados por uma câmera. Ele utiliza a biblioteca **MediaPipe** para rastreamento das mãos e calcula a distância entre os dedos para ajustar as propriedades do sistema.\n\n## Tecnologias Utilizadas\n\n- **Python**: Linguagem principal do projeto.\n- **OpenCV**: Captura e processamento de imagens.\n- **MediaPipe**: Detecção e rastreamento das mãos.\n- **Pycaw**: Controle do volume do sistema (somente para Windows).\n- **screen_brightness_control**: Ajuste do brilho da tela.\n\n## Funcionalidades\n\n- Detecção de mãos em tempo real.\n- Cálculo da distância entre o polegar e o indicador.\n- Ajuste do volume do sistema ao detectar a mão esquerda.\n- Ajuste do brilho da tela ao detectar a mão direita.\n- Exibição das mãos processadas na tela.\n\n## Estrutura do Projeto\n\n```\nControle por Gestos/\n│-- src/\n│   │-- controllers/\n│   │   │-- brightness.py\n│   │   │-- volume.py\n│   │   │-- controller.py\n│   │-- utils/\n│   │   │-- distance_calculator.py\n│   │-- hand_tracker/\n│   │   │-- initialize_detector.py\n│   │   │-- landmark_processor.py\n│-- main.py\n│-- pre-commit-config.yaml\n│-- setup.py\n│-- .gitignore\n│-- requirements.txt\n│-- README.md\n```\n\n## Como Executar\n\n1. Clone o repositório:\n   ```bash\n   git clone https://github.com/ericshantos/hand-control.git\n   cd hand-control\n   ```\n\n2. Crie um ambiente virtual (opcional, mas recomendado):\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # No Windows: venv\\Scripts\\activate\n   ```\n\n3. Instale as dependências necessárias:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Configure o pre-commit:\n   ```bash\n   pip install pre-commit\n   pre-commit install\n   ```\n\n5. Para testar o pre-commit manualmente:\n   ```bash\n   pre-commit run --all-files\n   ```\n\n6. Execute o script principal:\n   ```bash\n   python main.py\n   ```\n\n## Autor\n\nDesenvolvido por **Eric dos Santos**.\n\n- GitHub: [github.com/ericshantos](https://github.com/ericshantos)\n- LinkedIn: [linkedin.com/in/eric-sh](https://linkedin.com/in/eric-sh)\n- E-mail: ericshantos13@gmail.com\n\n## Licença\n\nEste projeto está licenciado sob a **Licença MIT** - veja o arquivo [LICENSE](LICENSE) para mais detalhes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericshantos%2Fhand_control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericshantos%2Fhand_control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericshantos%2Fhand_control/lists"}