Skip to content

Commit e8f5992

Browse files
committed
Update README.md
1 parent 0c08dc6 commit e8f5992

File tree

1 file changed

+17
-18
lines changed

1 file changed

+17
-18
lines changed

README.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,13 @@ The code relies on a number of body/face analysis libraries:
99

1010
* [MediaPipe](https://mediapipe.dev) -- to extract body and face landmarks
1111
* [MTCNN](https://github.com/ipazc/mtcnn) -- to extract face bounds
12-
* [OpenPose](https://github.com/CMU-Perceptual-Computing-Lab/openpose) -- for full body 3D landmarks extraction
1312
* [kkroening ffmpeg python](https://kkroening.github.io/ffmpeg-python/) -- to en/decode videos
1413
* ... more to come
1514

1615

1716
## Installation
1817

19-
Clone the repository and setup a python environment for it (Tested with v3.7).
18+
Clone the repository and setup a python environment for it (Tested with v3.11).
2019

2120
```sh
2221
python3 -m venv p3env-videotools
@@ -64,7 +63,7 @@ Draws a rectangle as overlay of an input frame sequence
6463

6564
Watch here the [draw_bbox help text](Docs/Help/draw_bbox.txt)
6665

67-
<img src="Docs/Pics/video-original.png" width="20%" alt="Cropping area"> + bbox {"x": 227, "y": 200, "width": 741, "height": 442 } ==> <img src="Docs/Pics/video-bboxarea.png" width="20%" alt="Cropping area">
66+
<img src="Docs/Pics/video-original.png" width="20%" alt="Cropping area"> + `{"x": 227, "y": 200, "width": 741, "height": 442 }` ==> <img src="Docs/Pics/video-bboxarea.png" width="20%" alt="Cropping area">
6867

6968

7069
### Crop Video
@@ -79,7 +78,7 @@ python -m slvideotools.crop_video --help
7978
Watch here the [crop_video help text](Docs/Help/crop_video.txt)
8079

8180

82-
<img src="Docs/Pics/video-bboxarea.png" width="30%" alt="Cropping area"> ==> <img src="Docs/Pics/video-cropped.png" width="30%" alt="Cropped video">
81+
<img src="Docs/Pics/video-original.png" width="20%" alt="Cropping area"> + `{"x": 227, "y": 200, "width": 741, "height": 442 }` ==> <img src="Docs/Pics/video-cropped.png" width="20%" alt="Cropped video">
8382

8483

8584
_Warning!!!_ The resolution of the output video might differ from the width/height specified in the JSON file. This is due to limitations of some codecs.
@@ -95,7 +94,7 @@ python -m slvideotools.extract_face_data --help
9594
Watch here the [extract_face_data help text](Docs/Help/extract_face_data.txt)
9695

9796

98-
<img src="Docs/Pics/video-original.png" width="30%" alt="Original Video">==><img src="Docs/Pics/video-facedata.png" width="30%" alt="Face Data Overlay. Blue dots: MediaPipe landmarks. Red dots: normalized landmarks">
97+
<img src="Docs/Pics/video-original.png" width="30%" alt="Original Video"> ==> <img src="Docs/Pics/video-facedata.png" width="30%" alt="Face Data Overlay. Blue dots: MediaPipe landmarks. Red dots: normalized landmarks">
9998

10099
For a reference about the landmark ID and its location on the face, please see the official MediaPipe docs [Here](https://raw.githubusercontent.com/google/mediapipe/master/mediapipe/modules/face_geometry/data/canonical_face_model_uv_visualization.png).
101100

@@ -239,26 +238,26 @@ with create_frame_producer(dir_or_video="my/frames/") as prod,\
239238

240239
### Environment preparation
241240

242-
# numpy-2.3.2
243-
# numpy==2.2.6
244-
# opencv-python-4.12.0.88
245-
246241
Tested with Python 3.11:
247242

248-
pip install the following packages
243+
Install the frozen requirements:
244+
245+
pip install -r requirements.txt
246+
247+
OR freshly install the following packages:
249248

250249
```
251-
numpy==1.26.4
252-
pillow==11.3.0
250+
pip install numpy==1.26.4
251+
pip install pillow==11.3.0
253252
254-
ffmpeg-python==0.2.0
255-
opencv-python==4.9.0.80
253+
pip install ffmpeg-python==0.2.0
254+
pip install opencv-python==4.9.0.80
256255
257-
mediapipe==0.10.21
258-
tensorflow==2.19.0
259-
mtcnn==1.0.0
256+
pip install mediapipe==0.10.21
257+
pip install tensorflow==2.19.0
258+
pip install mtcnn==1.0.0
260259
261-
pytest==8.4.1
260+
pip install pytest==8.4.1
262261
```
263262

264263
To use GPU on a Mac:

0 commit comments

Comments
 (0)