Skip to content
This repository has been archived by the owner on Sep 19, 2024. It is now read-only.

tbdsux/koyo

Repository files navigation

koyo

Web screenshot service api

API

You will need to create an API Key from your Koyo space app before communicating through the screenshot api outside of space app.

Structure

  • /api/screenshot

    Main screenshot api. Options can be viewed and modifed through your space app instance.

  • /api/drive/files

    List saved screenshot files from the default app drive. Filename is sorted with {iso-date-string}-{website-hostname}.{image-type} (Example: 2023-02-07T09:49:11.890Z-www.google.com.png)

  • /api/drive/files/{filename}

    Endpoint for saved screenshot filename. It will return the image buffer / data if it exists otherwise, will return an Error 404 json object.

Changelog

v0.3.0

  • Added API Keys for security purposes.
  • Added Save To Drive screenshot api option. Can also view saved screenshots.
  • Add more features for CLI

v0.2.0

  • Bug fixes and some minor adjustments and additions
  • Download image button

v0.1.1

Known Issues

  • Full page screenshot doesn't work on some websites.

Development

This project is a monorepo using pnpm.

  • Clone the repository

    git clone https://github.com/tbdsux/koyo.git
  • Install the dependencies

    pnpm install
  • Start development. This will run the both the api and frontend projects together simultaneously.

    pnpm dev

Project structure

  • api - Expressjs, main screenshot api.

  • website - Sveltekit website frontend.

© 2022 | tbdsux