https://github.com/feri-irawan/fiimage
Resize image, create video thumbnail, and create open graph image for your website.
https://github.com/feri-irawan/fiimage
generator hacktoberfest image image-resize og-image open-graph resize resize-image screenshot thumbnail video video-thumbnail web-capture web-screenshot
Last synced: 7 months ago
JSON representation
Resize image, create video thumbnail, and create open graph image for your website.
- Host: GitHub
- URL: https://github.com/feri-irawan/fiimage
- Owner: feri-irawan
- Created: 2022-12-29T17:29:26.000Z (about 3 years ago)
- Default Branch: 2.0
- Last Pushed: 2023-10-27T14:01:40.000Z (about 2 years ago)
- Last Synced: 2025-05-18T05:15:27.008Z (8 months ago)
- Topics: generator, hacktoberfest, image, image-resize, og-image, open-graph, resize, resize-image, screenshot, thumbnail, video, video-thumbnail, web-capture, web-screenshot
- Language: TypeScript
- Homepage:
- Size: 391 KB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# fiimage
Resize image and create a thumbnail of a video, made with ❤ by Feri Irawan at 28/12/2022
## Resize Image
```
GET /
```
The query strings are:
| Name | Description |
| -------------- | -------------------------------------------------- |
| `url` | The Image URL |
| `s` (optional) | The size will be generate. For example `s=100x100` |
### Auto Width
You can use the `?` mark, like this: `s=?x200`. This means the width will be auto and the height will be `200px`.
Example:
```
https://fiimage.vercel.app?s=?x200&url=https://images.unsplash.com/photo-1518791841217-8f162f1e1131
```
Output:
### Auto Height
Similar to [auto width](#auto-width), you can also use the `?` mark, like this: `s=200x?`
Example:
```
https://fiimage.vercel.app?s=200x?&url=https://images.unsplash.com/photo-1518791841217-8f162f1e1131
```
Output:
### Force width and height
You can use `s=300x200`, that means the width will be `300px` and height will be `200px`.
Example:
```
https://fiimage.vercel.app?s=300x200&url=https://images.unsplash.com/photo-1518791841217-8f162f1e1131
```
Output:
## Generate Video Thumbnail
```
GET /
```
The query strings are:
| Name | Description |
| -------------- | ------------------------------------------------------------------------------ |
| `url` | The Video URL |
| `s` (optional) | The thumbnail size (similar to [image resize](#resize-image)) |
| `t` (optional) | The time (in seconds) of the video that will be used to generate the thumbnail |
Example:
```
https://fiimage.vercel.app/?s=300x?&t=5&url=http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
```
Output:
## Create a Open Graph Image (og:image)
```
GET /og
```
The query strings are:
| Name | Description |
| --------------------- | ---------------------------------------------------------------------- |
| `url` | The your web URL (must be start with `https://` or `http://` protocol) |
| `template` (optional) | The template (for now you can choose `0` or `1`), default: `0` |
Example:
```
https://fiimage.vercel.app/og?url=https://github.com/feri-irawan/fiimage
```
Output:
Using template: `1`
> Stay tuned for the new template :)
## Contribution
If you wish to contribute to this project, please create a pull request and follow the contribution guidelines.
## License
This project is licensed under the MIT license.
Thank you, and hope it proves useful. Feel free to report issues or provide suggestions.