Skip to content

Commit a2f6fa7

Browse files
committed
Update readme
1 parent d1fedcf commit a2f6fa7

File tree

1 file changed

+29
-15
lines changed

1 file changed

+29
-15
lines changed

README.md

Lines changed: 29 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,58 +11,72 @@
1111

1212
[discord-shield-static]: https://img.shields.io/badge/Discord-landomrandom-121727?style=for-the-badge&labelColor=080c19&messageColor=e0e6f7&logo=discord&logoColor=00c6ff
1313

14-
**Pilko Studio** is a privacy-first, browser-based tool for extracting frames from your video files locally, offering a range of flexible extraction options. It works seamlessly on both desktop and mobile devices.
14+
Pilko Studio is a frame capture web tool that lets you extract screenshots from your videos in many different ways, manually or automated, locally within your browser. It works seamlessly on both desktop and mobile.
1515

1616
Try it here: https://pilko.studio
1717

18-
Offline download: `index.html`
18+
Offline: Download `index.html`
1919

20-
<video src="https://github.com/user-attachments/assets/77a1a585-3999-433d-a160-4b2940083120" controls width="600"></video>
20+
<video src="https://github.com/user-attachments/assets/2eb13ce0-5c57-4d8f-aaad-a23820f57534" controls width="600"></video>
2121

2222
## ![Features Shield][features-shield]
2323

2424
- Example video for first testing.
25-
- Video metadata display (resolution, duration, aspect ratio, bitrate).
26-
- Capture format (PNG, JPEG, WEBP) and quality (1-100%).
25+
- Video metadata display (resolution, duration, aspect ratio, estimated video bitrate).
26+
- Capture format (PNG, JPEG, WEBP) and quality configuration (1-100%).
2727
- Automatically remove black bars.
2828
- Add text and/or timecode overlays.
29-
- Output
29+
- Capture methods
3030
- `Manual` - Navigate video player to capture and save specific frames.
31-
- `Interval` - Capture frames automatically at set time intervals (seconds).
32-
- `Smart Auto` - Use algorithms (Histogram or Pixel Difference) to detect and capture visually distinct frames with adjustable sensitivity.
33-
- `Grid` - Create a grid of frames to a single image.
34-
- Configure filenames.
31+
- `Interval` - Extract frames at regular intervals (frames or seconds).
32+
- `Smart Auto` - Automatically detects scene changes and aims to capture only one frame per scene.
33+
- `Grid` - Generates a grid of screenshots to a single image.
34+
- Configure filenames for export.
3535
- Preview frames in a gallery/lightbox, remove unwanted frames, download individually or as ZIP.
36+
- Pro Mode - To support professional workflows
37+
- Set framerate for frame-accurate captures
38+
- SMPTE timecode overlay
39+
- Custom text overlay
40+
- Upload image/logo overlay
3641

37-
![Pilko_Panel](https://github.com/user-attachments/assets/46d4e68b-6992-43e3-83b4-92b56397703b)
42+
![Pilko_Panel](https://i.imgur.com/n5oZIt9.jpeg)
3843

3944
[features-shield]: https://img.shields.io/badge/Features-00c6ff?style=for-the-badge&color=121727
4045

4146
## ![Privacy & Processing Shield][processing-shield]
4247

4348
- No cloud processing or installations.
44-
- 100% client-side: built with HTML, CSS, and JavaScript.
4549
- Frames are stored temporarily in your browser.
50+
- 100% client-side: built into a single `.html` using native HTML, CSS and JavaScript.
51+
- Why? For trust and accessibility. Easy to deploy locally, no installatiosn required.
4652

4753
[processing-shield]: https://img.shields.io/badge/Privacy%20&%20Processing-00c6ff?style=for-the-badge&color=121727
4854

4955
## ![Use Cases Shield][use-cases-shield]
5056

51-
`thumbnails`, `lecture screenshots`, `visual notes`, `design references`, `mood board`, `film analysis`, `AI dataset building`, `Midjourney style references`
57+
- `thumbnails`
58+
- `lecture screenshots`
59+
- `visual notes`
60+
- `design references`
61+
- `mood board`
62+
- `film analysis`
63+
- `AI dataset building`
64+
- `Midjourney style references`
5265

5366
[use-cases-shield]: https://img.shields.io/badge/Use_Cases-00c6ff?style=for-the-badge&color=121727
5467

5568
## ![How it Works Shield][how-it-works-shield] [![Try it][demo-shield]][demo-url]
5669

5770
The tool finds timestamps (or you pick them). Your browser's built-in capabilities (`<video>`, `<canvas>`) capture the frame at that time, optionally cropping based on black bar detection, encode it to the selected image format, and provide the image data for display/download.
5871

72+
The tool doesn't do video extraction from links, such as Youtube, TikTok, Instagram, etc.<br>
73+
I recommend using [Media Download](https://github.com/mhogomchungu/media-downloader) or [Hitomi Downloader](https://github.com/KurtBestor/Hitomi-Downloader)
74+
5975
[how-it-works-shield]: https://img.shields.io/badge/How_it_Works-00c6ff?style=for-the-badge&color=121727
6076

6177
[demo-shield]: https://img.shields.io/badge/Try_it-00c6ff?style=for-the-badge&color=080c19
6278
[demo-url]: [URL](https://pilko.studio)
6379

64-
<video src="https://github.com/user-attachments/assets/16b17ae7-c46b-4b34-b45b-593505b835f5" controls width="600"></video>
65-
6680
## ![Feedback Shield][feedback-shield]
6781

6882
[![Email][gmail-shield]][gmail-url] ![Discord: landomrandom Status][discord-shield-static]

0 commit comments

Comments
 (0)