Telepic (tele = distance + pic = picture) is a lightweight and easy-to-use CLI tool + Flask-based web application for sharing images from a remote machine or server (e.g. a VM or EC2 instance). With just one command, Telepic generates a shareable link or QR code, letting others instantly view your images in their browser.
No need to set up complex SSH tunnels or file syncing — just run telepic <YOUR-IMAGE-FOLDER on the remote machine, and get a shareable link to view your images from anywhere!
Features ✨
- 📁 View images in any folder on a remote server
- 🔄 Sort images alphabetically or shuffle them randomly
- 🖼️ Supports common formats: JPG, PNG, JPEG, etc.
- 🔢 Paginate results: control how many images per page
- 🔗 Shareable public URL via localhost.run
- 🧾 Clean UI with filenames under each image
Requirements 📋
- Python 3.11+ 🐍
⚙️ Installation
Option 1: Install from PyPI
pip install telepic
Option 2: Install from source
- Clone this repository:
git clone https://github.com/rafaelpadilla/telepic.git
cd telepic
pip install -e .
🚀 Usage
Run the server on your remote machine (VM, EC2, etc.):
telepic <DIRECTORY-WITH-IMAGES> [OPTIONS]
Options:
--n INTEGER Number of images to display per page (default: 20)
--port INTEGER Port to run the server on (default: 5000)
--scrambled Display images in random order instead of alphabetically
Example:
telepic /path/to/images --n 30 --port 5000 --scrambled
This will start the server and generate a public URL via localhost.run. Open it in your browser and you're good to go!
🧪 Testing
First, install the package with development dependencies:
pip install -e .[dev]
Then run the tests:
./bin/lint && ./bin/test
📝 License
This project is licensed under the Apache 2.0.
🤝 Contribution
Contributions are welcome! 🙌
Found a bug or have a feature idea? Feel free to open an issue or a pull request.
Check out our CONTRIBUTING.md to get started.
1 maintainer
Metadata
1 maintainer
Release files for telepic 1.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| telepic-1.1.1.tar.gz | 171.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| telepic-1.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 338.6 kB
Release files / telepic-1.1.1.tar.gz
| Download URL | telepic-1.1.1.tar.gz |
|---|---|
| Size | 171.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c2b5106de50e831b42ea7673df570159d2a58577de2cfff3871ae643dd2aeffd
|
|
BLAKE2b-256 checksum How to use checksums |
d87873839033bfcb5db3dbab6c35c05e53aaa23ea152fcc1c7fa112d460402f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / telepic-1.1.1-py3-none-any.whl
| Download URL | telepic-1.1.1-py3-none-any.whl |
|---|---|
| Size | 167.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe92e5479debed930ba3294ea6f64827d15a89dc27120cc60da4595c89467e07
|
|
BLAKE2b-256 checksum How to use checksums |
9a769d29eb99e5967ebfeee8f43de5f4ece2ddca2fd5b2e72ff8eb479808ca42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
