Documentation Home
๐Ÿ“ Getting Started โ–ผ
Getting StartedEntering Book DetailsChapter ManagementAdjusting the Copyright Page
๐Ÿ“ Everything About TBooks โ–ผ
The VMTBook StoryAbout the VMTBookstBook DocumentationFor WritersPublisher Onboarding: Reclaiming Value, Redefining ReachGetting ReadThe Philosophy of Ownership & the tBookThe Blockchain Behind VMTBooksThe Crypto ConnotationReader Code of EthicstBook Redemption Policy
๐Ÿ“ Working with Themes โ–ผ
Working In Plain Jane ThemeCreating Newsletters
๐Ÿ“ Token Value Management โ–ผ
tBook Token ManagementVMTBook HUB & Pricing StrategyLong-Term Investment in Literature
๐Ÿ“ TBook Reader โ–ผ
About the VMTBook ViewerEntering Book Details

๐Ÿ” VMTBooks Viewer

VMTBooks Viewer

tBook Prerequisites

Secure reader for encrypted .vbook files with Bitcoin token validation

๏ฟฝ๏ธ

Secure Reading Required

For your security and privacy, .vbook files containing Bitcoin tokens can only be read using our secure client-side app. Files are never uploaded to servers - they remain on your device at all times.

๐Ÿ“ฑ

Install PWA (Recommended)

Get the full app experience with offline reading and automatic updates.

โœ… Install like native app: Install as a native app on any device. Works offline and provides a seamless reading experience.
โœ… Automatic updates
โœ… Desktop shortcuts
โœ… No installation needed
โœ… Same security level
โœ… Client-side processing
โœ… Zero server dependency

๐Ÿ“ฑ How To Install App

๐Ÿ“‹ Need help installing? Find Your Browser With Detailed Instructions Below

๐ŸŒ

Use Web Version

Access the secure reader directly in your browser without installation.

๏ฟฝ Open Secure Reader

๐Ÿ”’ Why Client-Side Only?

๐Ÿ” What is VMTBooks Viewer?

VMTBooks Viewer is a secure, client-side application for reading encrypted .vbook files that contain embedded Bitcoin tokens. Unlike traditional e-readers, this system prioritizes security and user privacy by processing everything locally on your device.

๐Ÿ›ก๏ธ

100% Client-Side Processing

Your .vbook files are decrypted and read entirely in your browser. Nothing is ever uploaded to our servers.

โ‚ฟ

Bitcoin Token Validation

Built-in support for books containing Bitcoin tokens. Verify and access your crypto assets securely.

๐Ÿ“ฑ

Progressive Web App

๐ŸŒ

Universal Compatibility

Works on any modern browser - Windows, Mac, Linux, iOS, Android. No downloads or installations required for basic use.

๐Ÿ”’

Zero Server Risk

Since files never leave your device, there's zero risk of data breaches, server compromises, or unauthorized access.

โšก

Lightning Fast

No upload wait times. Select your file and start reading immediately with instant decryption.

๐Ÿ”ง How It Works

Step 1. Choose Your Reader

Install the PWA for the full library experience, or use the web version for quick reading.

Step 2. Select Your .vbook File

Choose your encrypted .vbook file from your device. The file never leaves your computer.

Step 3. Secure Decryption

Your browser decrypts the file using advanced WebCrypto APIs. All processing happens locally.

Step 4. Read & Access Tokens

Enjoy your book and access any embedded Bitcoin tokens securely within the reader.

๐Ÿ“ฑ

Install VMTBooks Viewer

Get the full app experience! Install our secure book reader as a native-like app on your device.

โœ…
โœ… Desktop/mobile app shortcuts
โœ… Faster loading and performance
โœ… Same security as web version
โœ… Client-side file processing only
โšก

Lightning Fast

Instant loading

๐Ÿ“ฑ

App-Like

Native feel

๐Ÿ”’

Secure

Client-side encryption

๐Ÿ“ก

Offline Ready

Works without internet

Need help? Check our detailed installation guide

๐Ÿ“ฑ Install VMTBooks Viewer

๐Ÿš€ Quick Install (Recommended)

Skip the manual steps - use our one-click PWA installer!

๐ŸŽฏ Open PWA Installer โ†’

Opens in new tab - installs directly to client reader

Or follow the manual installation instructions below if you prefer step-by-step guidance.

๐Ÿง Linux User Quick Start

Chrome/Chromium: Look for install icon in address bar (easiest)
Firefox: Install "PWA for Firefox" addon first, then use it to install this site
Arch Linux: yay -S firefox-pwa

๐ŸชŸ Windows User Quick Start

Chrome/Edge: Look for install icon (โŠ•) in address bar - native PWA support!
Firefox: Click menu โ†’ "Install this site as an app"
Installed PWAs: Appear in Start Menu and can be pinned to taskbar

๐Ÿ“‹ Installation Steps

1

Look for the Install Icon

In your browser's address bar or menu, look for an install icon (usually a download arrow, plus sign, or app icon). This appears when a site can be installed as an app.

2

Click Install or Add to Home Screen

Click the install option. You may see "Install app", "Add to Home Screen", or "Install VMTBooks Viewer" depending on your browser.

3

Confirm Installation

A popup will appear asking you to confirm. Click "Install" or "Add" to complete the installation.

4

Launch Your New App

Once installed, find the app in your applications menu, desktop, or home screen and launch it like any other app. It will work even when you're offline!

๐ŸŒ Browser-Specific Instructions

๐ŸชŸ Windows (Chrome)

  1. Look for the install icon (โŠ•) in the address bar
  2. Or click menu (โ‹ฎ) โ†’ "Install VMTBooks Viewer"
  3. Click "Install" in the popup
  4. App appears in Start Menu and can be pinned to taskbar

๐ŸชŸ Windows (Edge)

  1. Look for the app icon (โŠ•) in the address bar
  2. Or click menu (โ‹ฏ) โ†’ "Apps" โ†’ "Install this site as an app"
  3. Enter app name and click "Install"
  4. Pin to taskbar for easy access

๐ŸŒ Chrome (Desktop & Mobile)

  1. Look for the install icon (โŠ•) in the address bar
  2. Or click menu (โ‹ฎ) โ†’ "Install VMTBooks Viewer"
  3. Click "Install" in the popup
  4. The app will open in its own window

๐ŸŒ Edge (Desktop & Mobile)

  1. Look for the app icon (+) in the address bar
  2. Or click menu (โ‹ฏ) โ†’ "Apps" โ†’ "Install this site as an app"
  3. Enter app name and click "Install"
  4. Pin to taskbar for easy access

๐Ÿง Linux (Firefox with PWA Support)

Note: Firefox on Linux requires the "PWA for Firefox" addon for full PWA support.
  1. Install "PWA for Firefox" addon from Firefox Add-ons store
  2. Follow the prompt to install the companion native program
  3. Use the addon to install this site as a PWA
  4. App will appear with its own icon and standalone window
Snap Firefox users: May need non-Snap Firefox version for best compatibility.

๐Ÿง Linux (Chrome/Chromium)

  1. Look for the install icon (โŠ•) in the address bar
  2. Or click menu (โ‹ฎ) โ†’ "Install VMTBooks Viewer"
  3. Click "Install" in the popup dialog
  4. App will be added to your applications menu

๐ŸฆŠ Firefox (Desktop)

  1. Click menu (โ˜ฐ) โ†’ "Install this site as an app"
  2. Or look for the install icon in address bar
  3. Choose installation location
  4. App will appear in your applications

๐ŸŽ Safari (iOS)

  1. Tap the Share button (โ–กโ†—)
  2. Scroll down and tap "Add to Home Screen"
  3. Edit the name if desired
  4. Tap "Add" to confirm

๐Ÿค– Android Browser

  1. Tap menu (โ‹ฎ) and select "Add to Home screen"
  2. Or look for the install banner at the bottom
  3. Tap "Add" or "Install"
  4. App icon will appear on home screen

๐ŸŽ Safari (macOS)

  1. Unfortunately, Safari doesn't support PWA installation
  2. Bookmark this page for quick access
  3. Or use Chrome/Firefox for full app experience
  4. Consider switching to a PWA-compatible browser

๐Ÿง Linux Users - Special Instructions

๐Ÿ”ง Firefox PWA Setup for Linux
Linux Firefox users need additional setup for full PWA support. Follow the steps below for the best experience.

๐ŸฆŠ Method 1: PWA for Firefox Addon (Recommended)

  1. Install the Addon:
    • Go to about:addons or Firefox menu โ†’ "Add-ons and themes"
    • Search for "PWA for Firefox" and install it
  2. Install Companion App:
    • The addon will guide you to install a native companion program
    • This enables standalone PWA functionality
  3. Install This PWA:
    • Use the addon to install this site as a PWA
    • App gets its own icon and standalone window
โš ๏ธ Firefox Version Compatibility:
โ€ข Snap Firefox: May have limitations due to containerization
โ€ข Flatpak Firefox: Check addon docs for workarounds
โ€ข Native Package: Best compatibility (recommended)

๐Ÿ—๏ธ Method 2: Arch Linux AUR Package

yay -S firefox-pwa

For Arch Linux users: Install directly from AUR for seamless PWA support.

๐ŸŒ Method 3: Chrome/Chromium (Easiest)

  1. Install via package manager or download from Google
  2. Navigate to this site
  3. Look for install icon in address bar
  4. Click "Install" - works natively without addons
โœ… Recommended for simplicity: Chrome/Chromium provides the best out-of-box PWA experience on Linux.
๐Ÿ’ก Linux PWA Tips:
โ€ข PWAs installed via browser appear in your applications menu
โ€ข They run in standalone mode (no browser UI)
โ€ข Desktop files are created automatically for easy launching
โ€ข Apps work offline and update automatically

๐Ÿ”ง Troubleshooting

Don't see an install option?
โ€ข Make sure you're using HTTPS (secure connection)
โ€ข Try refreshing the page
โ€ข Check if your browser supports PWAs
โ€ข Look for install prompts or banners
Installation failed?
โ€ข Clear browser cache and try again
โ€ข Make sure you have storage space available
โ€ข Try using a different browser
โ€ข Contact support if issues persist

๐Ÿ’ก Need Help?

Most documentation includes video examples to guide you through the process. If you need additional assistance or have questions:
Bluesky support DM me for questions or Check the video guides included with each article