Skip to content

Commit 89c03fb

Browse files
committed
add site OG tags
1 parent 9740e44 commit 89c03fb

File tree

3 files changed

+97
-1
lines changed

3 files changed

+97
-1
lines changed

README.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# 3D Hand Tracking Demo [Shape Creator]
2+
3+
A threejs / WebGL / MediaPipe-powered interactive demo that allows you to control create and move 3D shapes using hand gestures.
4+
5+
<img src="demo.png">
6+
7+
## Demo
8+
9+
Try the live demo: [https://collidingscopes.github.io/shape-creator-tutorial/](https://collidingscopes.github.io/shape-creator-tutorial/)
10+
11+
## Features
12+
13+
- **Real-time hand tracking** using MediaPipe Hands
14+
- **Left hand gesture control:** Pinch thumb and index finger to resize the 3D sphere
15+
- **Right hand interaction:** Touch the sphere with your index finger to change its color
16+
- **Responsive design** that works on desktop and mobile browsers
17+
- **Visual feedback** with color-coded hand tracking
18+
19+
## Requirements
20+
21+
- Modern web browser with WebGL support
22+
- Camera access
23+
- No additional software or downloads needed
24+
25+
## Technologies
26+
27+
- **Three.js** for 3D rendering
28+
- **MediaPipe** for hand tracking and gesture recognition
29+
- **HTML5 Canvas** for visual feedback
30+
- **JavaScript** for real-time interaction
31+
32+
## Setup for Development
33+
34+
```bash
35+
# Clone this repository
36+
git clone https://github.com/collidingScopes/shape-creator-tutorial
37+
38+
# Navigate to the project directory
39+
cd shape-creator-tutorial
40+
# Serve with your preferred method (example using Python)
41+
python -m http.server
42+
```
43+
44+
Then navigate to `http://localhost:8000` in your browser.
45+
46+
## License
47+
48+
MIT License
49+
50+
## Credits
51+
52+
- Three.js - https://threejs.org/
53+
- MediaPipe - https://mediapipe.dev/
54+
55+
## Related Projects
56+
57+
You might also like some of my other open source projects:
58+
59+
- [Threejs hand tracking tutorial](https://collidingScopes.github.io/threejs-handtracking-101) - Basic hand tracking setup with threejs and MediaPipe computer vision
60+
- [Particular Drift](https://collidingScopes.github.io/particular-drift) - Turn photos into flowing particle animations
61+
- [Liquid Logo](https://collidingScopes.github.io/liquid-logo) - Transform logos and icons into liquid metal animations
62+
- [Video-to-ASCII](https://collidingScopes.github.io/ascii) - Convert videos into ASCII pixel art
63+
64+
## Contact
65+
66+
- Instagram: [@stereo.drift](https://www.instagram.com/stereo.drift/)
67+
- Twitter/X: [@measure_plan](https://x.com/measure_plan)
68+
- Email: [stereodriftvisuals@gmail.com](mailto:stereodriftvisuals@gmail.com)
69+
- GitHub: [collidingScopes](https://github.com/collidingScopes)
70+
71+
## Donations
72+
73+
If you found this tool useful, feel free to buy me a coffee.
74+
75+
My name is Alan, and I enjoy building open source software for art, animation, games, and more. This would be much appreciated during late-night coding sessions!
76+
77+
[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/stereoDrift)

demo.png

3.98 MB
Loading

index.html

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,25 @@
66
<title>MediaPipe / Three.js Shape Creator</title>
77
<script defer src="https://cloud.umami.is/script.js" data-website-id="eb59c81c-27cb-4e1d-9e8c-bfbe70c48cd9"></script>
88
<link rel="stylesheet" href="styles.css">
9+
10+
<!-- Primary Meta Tags -->
11+
<meta name="title" content="Shape Creator Tutorial">
12+
<meta name="description" content="create/control 3D shapes with hand gestures">
13+
14+
<!-- Open Graph / Facebook -->
15+
<meta property="og:type" content="website">
16+
<meta property="og:url" content="https://collidingscopes.github.io/shape-creator-tutorial/">
17+
<meta property="og:title" content="Shape Creator Tutorial">
18+
<meta property="og:description" content="create/control 3D shapes with hand gestures">
19+
<meta property="og:image" content="https://raw.githubusercontent.com/collidingScopes/shape-creator-tutorial/main/demo.png">
20+
21+
<!-- Twitter -->
22+
<meta property="twitter:card" content="summary_large_image">
23+
<meta property="twitter:url" content="https://collidingscopes.github.io/shape-creator-tutorial/">
24+
<meta property="twitter:title" content="Shape Creator Tutorial">
25+
<meta property="twitter:description" content="create/control 3D shapes with hand gestures">
26+
<meta property="twitter:image" content="https://raw.githubusercontent.com/collidingScopes/shape-creator-tutorial/main/demo.png">
27+
928
</head>
1029
<body>
1130

@@ -19,7 +38,7 @@
1938
Hover over a shape / pinch to move it<br>
2039
Move a shape into the recycle bin to delete it
2140
</div>
22-
<p id="links-para"><a href="https://x.com/measure_plan" target="_blank">Twitter</a> | <a href="https://www.instagram.com/stereo.drift/" target="_blank">Instagram</a> | <a href="https://github.com/collidingScopes/threejs-handtracking-101" target="_blank">Source Code</a> | <a href="https://buymeacoffee.com/stereodrift" target="_blank">❤️</a></p>
41+
<p id="links-para"><a href="https://x.com/measure_plan" target="_blank">Twitter</a> | <a href="https://www.instagram.com/stereo.drift/" target="_blank">Instagram</a> | <a href="https://github.com/collidingScopes/shape-creator-tutorial" target="_blank">Source Code</a> | <a href="https://buymeacoffee.com/stereodrift" target="_blank">❤️</a></p>
2342

2443
<script src="https://cdn.jsdelivr.net/npm/@mediapipe/hands/hands.js"></script>
2544
<script src="https://cdn.jsdelivr.net/npm/@mediapipe/camera_utils/camera_utils.js"></script>

0 commit comments

Comments
 (0)