Local Content Share

 
 

Screenshots • Install & Use • Tips & Notes • Acknowledgements

---

A simple self-hosted app for sharing text snippets and files within your local network across any device. It also includes and a notepad to throw rough notes in. Think of this as a simple and elegant alternative to airdrop, local-pastebin and a scratchpad. The primary features are:

• Make plain text snippets available to view/share on any device in the local network
• Upload files and make them available to view/download on any device in the local network
• Built-in Notepad with both Markdown and Rich Text editing capabilities
• Rename text snippets and files uploaded to easily find them in the UI
• Edit text snippets to modify their content as needed
• Multi-file drag-n-drop (drop into the text area) support for uploading files
• Configurable expiration per file or snippet for 1 hour, 4 hours, or 1 day

From a technology perspective, the app boasts the following:

• Pure HTTP API, i.e., no use of websockets - this is good because it means no external communications needed for the sharing aspect
• Available as a binary for MacOS, Windows, and Linux for both x86-64 and ARM64 architectures
• Multi-arch (x86-64 and ARM64) Docker image for homelab deployments
• Works well with reverse proxies in the mix (tested with Cloudflare tunnels and Nginx Proxy Manager)
• Frontend available over browsers and as a PWA (so it shows as an app with an icon on the mobile home screens)
• Clean, modern interface with dark mode support that looks good on mobile too

Note

This application is meant to be deployed within your homelab only. There is no authentication mechanism implemented. If you are exposing to the public, ensure there is authentication fronting it and non-destructive users using it.

Screenshots

	Desktop View	Mobile View
Light
Dark

Expand for more screenshots

Desktop View	Mobile View

Installation and Usage

Using Docker (Recommended)

Use docker CLI one liner and setup a persistence directory (so a container failure does not delete your data):

mkdir $HOME/.localcontentshare

docker run --name local-content-share \
  -p 8080:8080 \
  -v $HOME/.localcontentshare:/app/data \
  tanq16/local-content-share:main

The application will be available at http://localhost:8080

You can also use the following compose file with container managers like Portainer and Dockge (remember to change the mounted volume):

services:
  contentshare:
    image: tanq16/local-content-share:main
    container_name: local-content-share
    volumes:
      - /home/tanq/lcshare:/app/data # Change as needed
    ports:
      - 8080:8080

Using Binary

Download the appropriate binary for your system from the latest release.

Make the binary executable (for Linux/macOS) with chmod +x local-content-share-* and then run the binary with ./local-content-share-*. The application will be available at http://localhost:8080.

Using Go

With Go 1.23+ installed, run the following to download the binary to your GOBIN:

go install github.com/tanq16/local-content-share@latest

Or, you can build from source like so:

git clone https://github.com/tanq16/local-content-share.git && \
cd local-content-share && \
go build .

Tips and Notes

• To share text content:
  • Type or paste your text in the text area (the upload button will change to a submit button)
  • (OPTIONAL) type the name of the snippet (otherwise it will name it as a time string)
  • Click the submit button (looks like the telegram arrow) to upload the snippet
• To rename files or text snippets:
  • Click the cursor (i-beam) icon and provide the new name
  • It will automatically prepend 4 random digits if the name isn't unique
• To edit existing snippets:
  • Click the pen icon and it will populate the expandable text area with the content
  • Write the new content and click accept or deny (check or cross) in the same text area
  • On accepting, it will edit the content; on denying, it will refresh the page
• To share files:
  • Click the upload button and select your file
  • OR drag and drop your file (even multiple files) to the text area
  • It will automatically append 4 random digits if filename isn't unique
• To view content, click the eye icon:
  • For text content, it shows the raw text, which can be copied with a button on top
  • For files, it shows raw text, images, PDFs, etc. (basically whatever the browser will do)
• To download files, click the download icon
• To delete content, click the trash icon
• To set expiration for a file or snippet
  • Click the clock icon with the "Never" text (signifying no expiry) to cycle between times
  • Set the cycling button to 1 hour, 4 hours, or 1 day before adding a snippet or file
  • For a non-"Never" expiration, the file will automatically be removed after the specified period
• The Notepad is for writing something quickly and getting back to it from any device
  • It supports both markdown and richtext modes
  • Content is automatically saved upon inactivity in the backend and will load as is on any device

A quick note of the data structure: the application creates a data directory to store all uploaded files, uploaded text snippets, notepad notes (in files, text, and notepad subfolders respectively). File expirations are saved in an expiration.json file in the data directory. Make sure the application has write permissions for the directory where it runs.

Acknowledgements

The following people have contributed to the project:

• TheArktect - Added CLI argument for listen address.
• Several other users who created feature requests via GitHub issues.