save_it

KO | EN

gitlite — search

#javascript #golang #go #android #machine-learning #rust #docker #java #cli #kubernetes #vue #awesome-list #security #ios

(★ 14)

A Telegram bot that lets you easily save and search images and videos from the internet.

save_it Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Save it
A Telegram bot that lets you easily save and search images and videos from the internet.

[![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://raw.githubusercontent.com/ThaddeusJiang/save_it/main/LICENSE)
[![DeepWiki](https://img.shields.io/badge/DeepWiki-ThaddeusJiang%2Fsave__it-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/ThaddeusJiang/save_it)

## Features

- [x] Download and store images and videos from the internet
- [x] Search images by semantic word
- [x] Find images by image

[![Telegram Playground](https://img.shields.io/badge/Telegram-@save__it__playground-26A5E4?logo=telegram&logoColor=white)](https://t.me/save_it_playground)

## supported services

- [x] https://x.com/
- [x] https://www.pinterest.com/
- [x] https://instagram.com/
- [x] https://bad.news/
- [ ] https://www.youtube.com/

## Usage

### Save

Just send a link to the bot.

https://github.com/user-attachments/assets/4a375cab-7124-44f3-994e-0cb026476d39

### Search

messages:

```
/search cat
/search dog
/search girl
/similar photo
```

When `/similar` finds matches, the bot sends `Similar photos found.` with the matching photos. Multiple matches are returned as a Telegram media group.

https://github.com/user-attachments/assets/b0dedcc0-3305-42b2-8101-6b0b5d32f17a

### Known limitations

- `/search` can still return occasional false positives for short semantic queries such as `/search girl`. This is a known limitation of the current Typesense image embedding model, and `save_it` does not plan to solve it locally.

## Self hosting

## Option 1: One-Click for Zeabur

[![Deploy on zeabur](https://zeabur.com/button.svg)](https://zeabur.com/zh-CN/templates/FTAONK)

## Option 2: Docker Compose

For X posts that require login or sensitive-content access, provide Cobalt cookies through a local ignored file:

```json
{
  "twitter": [
    "auth_token=<token>; ct0=<csrf>"
  ]
}
```

Save the file as `cobalt-cookies.json` at the repository root before starting Docker Compose.

```sh
docker-compose --profile prod up -d
```

## Development

Local development commands are available as Mix aliases:

```sh
mix setup   # deps.get + ts.migrate
mix dev     # run the bot with iex --no-halt
mix reset   # remove local runtime data directory (`data`)
```

## Build with

- [Elixir](https://elixir-lang.org/)
- [ex_gram](https://github.com/rockneurotiko/ex_gram) a powerful Elixir library for building Telegram Bots.
- [cobalt](https://github.com/imputnet/cobalt) a media downloader.
- [ffmpeg](https://ffmpeg.org/) for HLS video downloading.
- [Typesense](https://typesense.org/) Lightning Fast, Open Source Search

## License

[GPL-3.0](./LICENSE)

## Creator

- [ThaddeusJiang](https://github.com/ThaddeusJiang)

save_it

save_it Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

save_it

save_it Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README