Skip to content

VigiLens is a privacy-focused Android Background video recording solution that operates silently in the background. Built with security in mind, it offers HD/FHD recording capabilities, screen-lock activation, and local-only storage without any cloud dependencies. Perfect for surveillance, personal security, and discreet recording needs.

License

Notifications You must be signed in to change notification settings

ShashiLab/VigiLens

VigiLens - Silent. Secure. Seamless.

Elevate your recording experience with VigiLens - the most sophisticated background video recording solution for Android.

Logo
Logo

 __      __ _        _ _                    
 \ \    / /(_) __ _ (_) |     ___ _ __  ___ 
  \ \  / / | |/ _` || | |    / _ \ '_ \/ __|
   \ \/ /  | | (_| || | |___|  __/ | | \__ \
    \__/   |_|\__, ||_|_____|\___|_| |_|___/
              |___/                          

Downloads
License Release Android

Note

🎉 Big News! VigiLens is now open source! As of January 1st, 2025, we've made our entire codebase public to foster community collaboration and transparency.

🌟 What Makes VigiLens Special?

Tip

VigiLens is designed with privacy and ease of use in mind. No Cloud Sync - your data stays on your device!

Key Features That Set Us Apart

🔒 Absolute Privacy

  • Zero internet connectivity for complete data security
  • Local-only storage with password protection
  • No data collection or external sharing
  • Built-in App Lock

⚡ Performance Beast

  • Minimal battery drain for extended recording
  • Background recording with screen off
  • Seamless multitasking capability
  • Quick shortcuts for instant recording

🎥 Professional Grade

  • Crystal clear HD/Full HD (1920x1080) recording
  • Unlimited recording time with no restrictions
  • Smart quality adaptation for storage optimization
  • Silent recording mode for discretion
  • Customizable recording preview options

🔐 Unique Features

  • Screen Lock Icon ("⏻") for instant recording
  • Automatic recording stop on screen unlock
  • One-click gallery export
  • Custom home screen shortcuts
  • Intuitive user interface for all skill levels

📱 The VigiLens Experience

Home Screen & Quick Start

Home Screen - Start your recording journey

[!TIP] The clean, intuitive interface puts all controls at your fingertips

Live Preview & Recording

Live Preview - Watch while you record

[!NOTE] Real-time preview available while recording

Video Management

Video Gallery Video Actions Video Details

[!TIP] Manage, organize, and protect your recordings with ease

Quick Access & Controls

Quick Controls Quick Access Settings

[!NOTE] Multiple ways to control recording - choose what works best for you

🚀 Getting Started

System Requirements

Important

Before installation, ensure your device meets these requirements:

  • Android 8.0 or higher
  • Minimum 50MB free storage
  • Camera and audio permissions
  • Notification permission

Permission Setup

Permission Setup

[!CAUTION] All permissions are used locally and are essential for proper functioning

Installation Methods

  1. Official Website (Recommended)

    https://vigilens.shashi.app/download
    
  2. GitHub Releases

  3. Build from Source

    # Clone the VigiLens repository from GitHub to your local machine
    git clone https://github.com/ShashiLab/VigiLens.git
    # Change directory to the cloned VigiLens project
    cd VigiLens
    # Build the project and assemble the release version using Gradle
    # This command compiles the code and creates a release APK (or artifact)
    ./gradlew assembleRelease

📖 Quick Start Guide

graph TD
    A[Install VigiLens] --> B[Grant Permissions]
    B --> C[Configure Settings]
    C --> D[Choose Recording Method]
    D --> E[Start Recording]
    E --> F[Manage Recordings]
Loading

Recording Methods

Method Activation Best For
Power Button (⏻) Shortcut Screen lock This will lock your screen and quickly start recording. When you unlock screen, recording will automatically stop to maintain discreet silent recording
Widget Home screen tap Regular use / Quick Record
In-App App interface Full control

⚙️ Advanced Features

Recording Modes

Tip

Choose the mode that best fits your needs:

Resolution Description
144p Basic low-resolution recording, suitable for minimizing file size and data usage
240p Improved clarity over 144p while maintaining small file size
360p Standard definition recording, balanced quality and size
480p Enhanced standard definition with sharper detail
720p HD High definition recording with excellent clarity
1080p Full HD Full high definition recording with maximum detail
Full Potential Automatically selects optimal recording settings based on your device capabilities and available storage

Note

Higher resolutions require more storage space and processing power. Consider your device specifications and storage capacity when selecting a recording mode.

Storage Management

Important

Enable automatic cleanup to prevent storage issues:

graph LR
    A[Recording] --> B[Storage Check]
    B --> C{Space Available?}
    C -->|Yes| D[Continue]
    C -->|No| E[Auto Cleanup]
    E --> D
Loading

🛠️ Development Guide

Development Setup

# Required tools
- Android Studio Arctic Fox+
- JDK 11+
- Android SDK 30+
- Gradle 7.0+

# Setup steps
1. Fork repository
2. Clone locally
3. Open in Android Studio
4. Sync Gradle
5. Build project

Project Structure

          VigiLens
            ├── VigiLens.java
            ├── about
            │   └── AboutActivity.java
            ├── core
            │   ├── notification
            │   │   └── UrgentAnnouncementManager.java
            │   └── permission
            │       └── PermissionActivity.java
            ├── feature
            │   ├── gallery
            │   │   ├── adapter
            │   │   │   └── VideoAdapter.java
            │   │   ├── service
            │   │   │   └── VideoSaveService.java
            │   │   ├── ui
            │   │   │   ├── GalleryFragment.java
            │   │   │   ├── GalleryViewModel.java
            │   │   │   └── VideoPlayerActivity.java
            │   │   └── util
            │   │       └── VideoSaver.java
            │   ├── main
            │   │   ├── DrawerNavigationManager.java
            │   │   └── MainActivity.java
            │   ├── recording
            │   │   ├── service
            │   │   │   └── VideoRecordingService.java
            │   │   ├── ui
            │   │   │   ├── FloatingPreviewView.java
            │   │   │   ├── RecordingFragment.java
            │   │   │   └── RecordingViewModel.java
            │   │   └── util
            │   │       ├── CameraSettings.java
            │   │       ├── MediaRecorderManager.java
            │   │       └── NotificationManager.java
            │   ├── security
            │   │   ├── DisablePasswordActivity.java
            │   │   ├── EnterPasswordActivity.java
            │   │   ├── ResetPasswordActivity.java
            │   │   └── SetPasswordActivity.java
            │   ├── settings
            │   │   ├── SettingsFragment.java
            │   │   ├── SettingsViewModel.java
            │   │   └── quickaccess
            │   │       ├── ShortcutsSettingsActivity.java
            │   │       └── ShortcutsSettingsViewModel.java
            │   ├── shortcut
            │   │   ├── back
            │   │   │   └── BackRecordActivity.java
            │   │   ├── front
            │   │   │   └── FrontRecordActivity.java
            │   │   ├── lockscreen
            │   │   │   └── LockAndRecordActivity.java
            │   │   └── quick
            │   │       └── QuickRecordActivity.java
            │   └── widget
            │       ├── back
            │       │   └── BackRecordWidgetProvider.java
            │       ├── front
            │       │   └── FrontRecordWidgetProvider.java
            │       ├── lockscreen
            │       │   └── LockAndRecordWidgetProvider.java
            │       └── quick
            │           └── QuickRecordWidgetProvider.java
            ├── support
            │   ├── FeedbackActivity.java
            │   └── ReportBugActivity.java
            └── utils
                ├── CommonUtils.java
                ├── DeviceUtils.java
                ├── admin
                │   └── DeviceAdminManager.java
                ├── broadcast
                │   └── RecordingStopReceiver.java
                ├── feedback
                │   └── GitHubRatingManager.java
                └── locale
                    └── LocaleManager.java

🔒 Security Features

Caution

Always enable device encryption and the built-in app lock for maximum security!

  • Secure File System: All recordings are stored within the app's internal storage, ensuring no external exposure.
  • Privacy-Focused Design: Built to prioritize user privacy.

Permission Usage

Permission Purpose Usage
CAMERA Video capture For recording only.
AUDIO Sound recording Optional.
NOTIFICATION Show notifications Used for event alerts.

📞 Support Channels

Getting Help

Community

  • GitHub Discussions
  • Telegram Support Group

📄 Legal Information

Warning

Check local laws regarding video recording in your jurisdiction

🌟 Roadmap

gantt
    title VigiLens Development Roadmap 2025
    dateFormat YYYY-MM-DD
    section Core Features
    Enhanced Encryption    :2025-01-01, 90d
    Cloud Backup (Optional) :2025-04-01, 120d
    AI Detection          :2025-07-01, 150d
    section Improvements
    UI Refresh           :2025-01-01, 60d
    Performance Optimization :2025-03-01, 90d
    New Widgets          :2025-06-01, 45d
Loading

❤️ Acknowledgments

Special Thanks To:

  • Our amazing user community
  • Open source contributors
  • Beta testing team
  • Android development community

Note

Want to contribute? Check our Contributing Guidelines!


Made with ❤️ by the VigiLens Team

WebsiteGitHubReport Issues

About

VigiLens is a privacy-focused Android Background video recording solution that operates silently in the background. Built with security in mind, it offers HD/FHD recording capabilities, screen-lock activation, and local-only storage without any cloud dependencies. Perfect for surveillance, personal security, and discreet recording needs.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages