JANUSEYE - Installation Guide

Installation

Deploy your guardian in minutes

1. System Prerequisites

JanusEye is now universal. While it is highly optimized for Raspberry Pi OS, it works perfectly on Debian and all its derivatives, including Ubuntu, Linux Mint, and Kali Linux. Ensure that Python 3 is installed on your system.

2. Get the Project

🚀 JANUSEYE PACK V-2026

VIEW files ON GITHUB DOWNLOAD ZIP from GITHUB

📦 Archive Content - JanusEye v2.0.3

The ZIP archive contains an organized structure for optimal performance:

  • 📂 Root Files:
    • app.py: The main system core (Flask Server).
    • install_januseye.sh: Universal smart installation script.
    • uninstall_januseye.sh: Clean uninstallation script.
    • backup_januseye.sh: Backup for your settings.
    • clean_videos.sh: Automatic disk space cleanup.
  • 📂 System Folders:
    • logs/: Activity logs (januseye.log).
    • videos/: Storage for alerts and captures.
    • config/: settings.json, presence.txt.
    • templates/: Web interface files (index, galerie, login, etc.).

3. Transfer Files

Transfer the JanusEye folder to your machine's home directory (e.g., /home/username/). The easiest method is to use FileZilla (SFTP mode).

  1. Connect via SFTP (Port 22) using your system credentials.
  2. Navigate to your user folder (e.g., /home/pi or /home/user).
  3. Ensure your folder is named exactly JanusEye.
  4. Right-click > Upload.

4. Hardware Verification

JanusEye is compatible with most cameras, including standard USB Webcams and official Raspberry Pi CSI modules.

🔍 Quick Detection Test

Before launching the installation, verify that your hardware is recognized by the system with this command:

v4l2-ctl --list-devices
💡 SMART INSTALLATION (V2.0.3): If you are using an official ribbon camera (CSI) on a Raspberry Pi (Trixie/Bookworm), the script will automatically detect it and enable Legacy mode. On Debian/Ubuntu PC, it skips this step and focuses on standard USB driver optimization.

✅ If you see "/dev/video0": Your camera is ready!

❌ If nothing appears: Check your physical connections (USB plug or ribbon cable).

5. Automated Installation

Launch the universal installer from your terminal:

# 1. Make the script executable

chmod +x ~/JanusEye/install_januseye.sh

# 2. Run the installation

sudo ~/JanusEye/install_januseye.sh
What does the "Smart" installation script do?
  • System Detection: Automatically identifies Debian, Ubuntu, Mint or Raspberry Pi.
  • Camera Config: Enables Legacy drivers only if hardware requires it.
  • Disk Space: Checks for sufficient free space (< 5.3 GB required).
  • Environment: Installs Flask, OpenCV, and sets up a secure Python Virtual Environment (VENV).
  • Auto-Start: Configures januseye.service to start automatically when the machine boots up.

⚠️ Note: If the script modifies system firmware (on Pi), a sudo reboot will be requested.

6. First Access and Configuration

The default PIN code is 1234.

http://your_machine_ip:5000/
⚠️ SECURITY: Change the default "1234" PIN immediately in the SETTINGS tab. To prevent intrusion, the system records and blocks any IP ADDRESS after 3 failed attempts.

🗑️ Uninstalling JanusEye

To cleanly remove JanusEye from your system (stopping services and cleaning up files), use the dedicated script:

# 1. Make the script executable

chmod +x ~/JanusEye/uninstall_januseye.sh

# 2. Run the uninstallation

~/JanusEye/uninstall_januseye.sh
Note: You will be given the choice to keep or delete your recorded alert videos during the process.
⬅️ Back to previous page