homeaboutvideotry it nowpricingdocs
File backend for developers

Uploads, image resizing and video. One script tag, one URL.

Fileboy is the file backend we built for our own apps and have run in production for years. Upload a file, get an ID back, then serve any size, crop or format from a URL. Upload a video and get adaptive streaming and a player. No buckets, no image pipeline, no ffmpeg.

Free plan, no card. Running in production for years.
1Upload
Drop an image here, or click to choose
It goes to a shared demo account and is deleted after 24 hours. No sign-up.
or use a sample:
2Change it with the URL
Upload an image and the controls appear here.

You could build this. You would rather ship your product.

File handling looks like a weekend job. It turns into a bucket, a policy, an upload signer, an image worker, a cache, a video encoder and a bill you cannot predict.

Doing it yourself

  • Set up storage, permissions and CORS
  • Write and secure an upload endpoint
  • Run an image service and a cache in front of it
  • Run and monitor video encoding
  • Pay for compute while it sits idle

With Fileboy

  • Paste your public key into the uploader
  • Store one file ID per file
  • Change size, format and quality in the URL
  • Upload a video and get an HLS stream
  • Pay a flat monthly price per app

Everything between “choose file” and “show file”

Six things you would otherwise build, test and look after. Each one works from the first request.

Uploads that just work

Drop in the browser uploader or the React component. Progress, large files and signed uploads are handled. You get back one ID.

Resize with a URL

Ask for the width, crop, format and quality you need in the image URL, add your logo or a text watermark, or get its main colours for a placeholder. format:auto serves AVIF to browsers that take it: about 30% smaller than WebP on our test photos, at the same quality. Fileboy makes each image on the first request, then caches it.

Video, streamed

Upload a video and get adaptive HLS and DASH streaming, a poster image, captions and a player. No ffmpeg server of your own.

You decide who sees what

Apps are public by default. Turn on signed URLs and files, images and videos are only served through expiring links your server signs. Or share one file with a link that expires, and turn it off early if you need to. List your websites, and other sites can't put your public key in their pages.

Folders, metadata and labels

Put files in nested folders, attach your own key and value data, and find files again by either, or by size, upload date and image dimensions, and save the searches you use as views for you or your team. Moving a file never changes its link, and a folder downloads as one zip. Photos come with their camera, date taken and location read for you, kept private to your team.

Cached delivery

Files and every transformed version are served from a cache, so repeat requests are quick and your servers stay out of it.

Video hosting API

Upload a video. Stream it everywhere.

Video is usually the part that makes a file service painful: an encoding job, a queue, somewhere to run it and a player to build. Fileboy does the encoding and gives you the player.

  • Encoded at sizes from 240p to 1080p, with a separate audio track, and streamed as adaptive HLS or DASH
  • A poster image picked for you, seek-preview thumbnails, an M4A audio download, and captions you upload per language
  • A player for any web page or framework, an iframe embed, or any HLS or DASH player
  • A webhook when the video is ready, so you never poll
curl https://api.fileboy.io/videos/upload \
  -H "Authorization: public YOUR_PUBLIC_KEY" \
  -F "file=@./clips/launch.mp4;type=video/mp4" \
  -F 'data={"name":"Launch day"}'

# { "id": "4a7b8f2e-...", "name": "Launch day", ... }

Add it in the time it takes to read this

A public key, a script tag and an input. Or a React component. Or one call from Node, Ruby, Python, PHP or cURL. Your app stores a file ID and builds URLs from it.

<script>FILEBOY_PUBLIC_KEY = "YOUR_PUBLIC_KEY"</script>
<script src="https://unpkg.com/@cd2/fileboy-browser"></script>

<!-- Upload: the input's value becomes the file ID -->
<input type="hidden" data-fileboy name="avatar" />

<!-- Deliver: any size, any format, from the ID -->
<img src="https://api.fileboy.io/images/get/FILE_ID?transform=resize:200x_;format:auto" />

Start free. Pay a flat price when you grow.

Each app has its own plan, so a side project never raises the bill for your main product. Transformations are unlimited on every plan.

Free
£0 / month
  • 1,000 files
  • 3 videos
  • 5 GB storage
  • 5 GB transfer
  • Unlimited transformations
  • Signed URLs for private files
Pro
£20.99 / month (≈ $27)
  • 5,000 files
  • 50 videos
  • 5 GB storage
  • 100 GB transfer
  • Unlimited transformations
  • Signed URLs for private files
Max
£92.99 / month (≈ $121)
  • 20,000 files
  • 200 videos
  • 20 GB storage
  • 200 GB transfer
  • Unlimited transformations
  • Signed URLs for private files

Built because we kept rebuilding it

We build software for clients and for ourselves. Every project needed uploads, resized images and sometimes video, and every project got a slightly different, slightly worse version. So we wrote it once, properly, and put our own apps on it.

Fileboy has been serving our production apps for years. We use it every week, we fix it when it annoys us, and you can email the people who wrote it at hello@fileboy.io.

Questions developers ask

Is there a free plan?

Yes. The free plan needs no card. It includes 1,000 files, 3 videos and 5 GB of transfer, which is enough to build and test a real integration.

What happens when an app nears its plan's limits?

Fileboy emails the app's members and shows a banner in the dashboard at 80% and 100% of its file, video and storage limits, and can send a webhook too. You can change the thresholds and who is told. The file limit is the only hard cap: at 100% new uploads are refused until you delete files or move to a bigger plan.

Does Fileboy handle video?

Yes. Upload a video and Fileboy encodes it in the background at sizes from 240p up to 1080p, picks a poster image, makes seek-preview thumbnails and serves adaptive HLS and DASH streaming, with the soundtrack as an M4A download. Play it with the React player, a script tag, an iframe or any HLS or DASH player, and add captions per language. It is on-demand video only: there is no live streaming, and anyone who has a video's id can play it unless the app turns on signed URLs. The video page has the details.

Which image transformations are supported?

Resize, crops (including smart crop), rotate, colour and blur effects, rounded corners, format conversion (AVIF, WebP, JPEG, PNG) and quality are available on every plan, along with logo and text overlays for watermarks. format:auto serves AVIF or WebP to browsers that take them. The image transforms docs list the full set and how to chain them in one URL. The palette transform answers with an image's main colours, with a readable text colour for each, as JSON or CSS.

Can I send someone a file with a preview page?

Yes. Turn on a file's share page in the dashboard or through the API and send its link. It shows a preview (images, PDFs, video, audio and text), the file's name and size and a download button, and the link unfurls with a thumbnail in chat apps. Pages are off until you turn them on and are kept out of search engines. A file set to Signed URLs only stays private: its page only opens through a link your server signs.

Can I keep files private?

Yes. Turn on signed URLs for an app and every file, image and video can only be read through a URL your server signs with your private key, which stops working at a time you choose. You can also make single files private by setting their read permission to Signed URLs only. Public keys are safe to ship in browser code: they can upload, but editing and deleting files needs your private key.

Can I stop other websites using my public key?

Yes. List your sites under Allowed origins in the app's settings, like https://example.com and https://*.example.com, and uploads with your public key from a page on any other site are refused. It is checked from the Origin header browsers send, so it stops other websites, not someone calling the API directly with a made-up header. When uploads must be locked down, have your server hand the page a short-lived upload token, or upload with your private key.

Does Fileboy read EXIF data from photos?

Yes. The camera, lens, exposure, date taken, orientation and GPS position are read from JPEG, PNG, WebP, TIFF and HEIC photos when they are uploaded, and shown on each file's page and through the API. Locations and serial numbers are only shown to your team and your private key, and an app setting removes the location from photos as they are uploaded.

What counts towards my storage?

Everything your app stores: the files you upload, each video's original, its streaming renditions, posters and captions, and the resized copies Fileboy caches so images load fast. Each app's Storage page shows the total against your plan, split into those kinds, with your biggest files and videos and a daily total, and the API returns the same numbers.

Can I share a file with a link that expires?

Yes. On a file's page in the dashboard, or through the API, make a link that stops working after an hour, a day, a week, a month or at a date and time you pick, up to a year. It can open the file, a download or a resized image. You can turn a link off early and see how often it was opened. If the file itself is public, its own URL keeps working, so set it to Signed URLs only when the link should be the only way in.

Can a webhook fire only for some files?

Yes. Each webhook endpoint picks its event types, and can filter file uploads and deletes by file type (like image/* or application/pdf), label, folder and metadata. Events the filters skip are never sent, and the endpoint's delivery log says why. Video and usage events are chosen by event type only.

Can I download many files at once?

Yes. On the Files page, pick the files you want and press Download zip, or download a whole folder with the folders inside it. From your server, the API zips up to 1,000 files or a folder, up to 10 GB, and can give a browser a link that downloads the zip for up to an hour. Folders are kept inside the zip and names are made safe and unique. Zips hold the original files.

Do I need to change my backend?

Not much. The browser uploader and React component talk to Fileboy directly. Your backend only stores the file ID that comes back, the same way it would store any other string.

Which languages and frameworks are supported?

There are official libraries for the browser, React, Node, Ruby, Python and PHP, so Rails, Django and Laravel apps are covered. Everything is also available over a plain HTTP API with a published OpenAPI spec, so any other language can generate a client.

Who builds Fileboy?

CD2 Solutions, a small UK software company. We wrote Fileboy because we kept rebuilding the same file handling for client projects, and we have run it in production for years.

Want to see more of what we're building?

Leave your email below and we'll let you know how we're progressing with Fileboy and updates that may interest you.