The File Share plugin allows users to securely share files between Obsidian vaults using end-to-end encryption. By leveraging a socket server, users can directly transfer files by simply exchanging a key with their friends and saving it in a friend list. A default server hosted in Germany is available, but users can also set up their own socket server using the provided Docker image or direct machine setup. The plugin ensures secure and private file sharing, making it an ideal solution for collaboration while maintaining data integrity.
Latest Update - October 19, 2025
📝 TL;DR
Quick summary of what's new:
- ⌨️ Keyboard shortcuts - Send files instantly with hotkeys (general + per-friend)
- 📁 Folder sharing - Send entire folders with one click
- 📊 Large files - Now supports files up to 500MB (automatic chunking)
- 🎨 Visual feedback - See transfer status in your file explorer
- 📋 Folder structure - Choose to preserve or flatten folder hierarchy
- ⚠️ Custom server users: Update required for chunked file transfer!
🚀 New Features
⌨️ Keyboard Shortcuts for Quick Sending
You can now set up keyboard shortcuts to send files even faster!
Two ways to use shortcuts:
General "Send to…" shortcut
- Opens the friend selection menu instantly
- Perfect when you want to choose who to send to
- Go to Settings → Hotkeys, search for "Send current file to…" and assign your preferred shortcut
Direct shortcuts for each friend
- Send directly to a specific friend without any menus!
- Just toggle "Enable hotkey" next to any friend in settings
- Click the ⚙️ settings icon to quickly set up your keyboard shortcut
📁 Send Entire Folders
You can now share complete folders with all their files at once!
- Right-click any folder → "Send folder to…"
- All files inside (including subfolders) will be sent
- Your friend receives them with the same folder structure
- Invalid files are automatically skipped with a notification
📊 Better File Size Support
We now support sending much larger files:
- Files up to 500MB can be sent
- Large files are automatically split into smaller chunks
- You'll see a progress indicator while sending/receiving
- Everything is still encrypted and secure
🎨 Visual Feedback
New visual indicators show you what's happening:
- 🔄 Spinning icon when a file is being sent
- ✅ Checkmark when successfully sent
- ❌ Error indicator if something went wrong
- See the status directly in your file explorer
📋 Folder Structure Preservation
New option in settings: "Preserve folder structure"
- Enabled (default): Files are saved in the same folder structure as they were sent
- Disabled: All files go directly into your receive folder
- Perfect if you prefer to organize files yourself
✨ Improvements
Organized Settings
Settings are now better organized:
- Main settings are easy to find
- Advanced options (like chunk size) are in a separate collapsible section
- Clearer descriptions for each option
- Smarter default values
Release Notes
The plugin now automatically shows you what's new when it updates!
- You'll see this screen once per version
- Catch up on new features you might have missed
- Links to full documentation
🛡️ Security & Reliability
Everything is Still Secure!
All the security features you rely on are still there:
- End-to-end encryption with RSA-2048 + AES-256
- Files are encrypted before leaving your device
- Only your intended recipient can decrypt them
- We've added 133 automated tests to ensure everything works perfectly
Connection Checks
The plugin now checks:
- If you're connected to the server before sending
- If your friend is online before starting the transfer
- Proper validation at every step
⚠️ Important: Server Update Required
Custom Server Users
If you're running your own instance of the File Share server, you must update to the latest version to support the new chunked file transfer feature!
How to update:
Using Docker:
docker pull jloferer96/obsidian-file-share-server:latest
docker restart <your-container-name>From source:
git clone https://github.com/muckmuck96/obsidian-file-share-server
cd obsidian-file-share-server
# Follow installation instructions in the repositoryRepository: https://github.com/muckmuck96/obsidian-file-share-server
Note: If you don't update your server, large files (>256KB by default) will fail to transfer!
Using Default Server?
If you're using the default server (wss://ws-fileshare.asss.ist), no action needed - it's already updated! 🎉
📚 Need Help?
- Check the documentation for detailed guides
- Report issues on GitHub
- All your existing files and settings are safe - nothing breaking changed!
Enjoy the new features! 🎉
Thanks for using File Share - your secure, encrypted file sharing plugin for Obsidian!