ggcam

English · Français

English

Your phone has a great camera but no storage left? Use it as your camera: the picture and sound are sent live to your computer, and your videos are saved on the computer's disk.

And that's not all: you also get a live preview on the big screen, so you can frame your shots while you film your content. No app to install, no complicated setup.

Install (once)

1. Install Node.js (the "LTS" version) from nodejs.org.

2. Open a terminal (on Windows: PowerShell, or WSL if Node.js is also installed on Windows) and run:

   npm install -g @ourssympa/ggcam

Start

In a terminal, from any folder:

ggcam

Your browser opens https://localhost:8443 (on Windows it opens by itself; on other systems, open that address yourself).

The first time:

• The browser warns that the connection is not private. That's normal (the certificate is created on your computer): click Advanced, then Continue.
• Windows asks whether Node.js may use the network: tick Private networks and confirm.

Film

1. Connect the phone and the computer to the same Wi-Fi.
2. Scan the QR code shown on the computer with your phone's camera.
3. Safari shows "This connection is not private": tap Show Details › visit this website › Visit Website. It only asks once.
4. Tap Start camera, then allow the camera and microphone.
5. The picture appears on the computer. Click the record button (or press R) to record. When you stop, the video is saved in your computer's Downloads folder.

On the computer: F full screen, M sound on/off, R record. On the phone: switch lens, choose 720p or 1080p, and tap the red button to record — it asks whether to record on the phone or on the computer, so you can start the computer's recording without leaving your spot.

If something goes wrong

• The phone can't open the page: make sure both devices are on the same Wi-Fi and that the address picked under the QR code is the Wi-Fi one (e.g. 192.168.1.x). In Windows, set your Wi-Fi network to Private and allow Node.js in the firewall.
• The page opens but no picture shows up: turn off any VPN on the computer. Guest or public Wi-Fi networks often block devices from talking to each other: use your home Wi-Fi or your phone's hotspot.
• Camera blocked: on the iPhone, Settings › Safari › Camera / Microphone › Allow, then reload the page.
• The picture freezes when you switch apps: iOS stops the camera when Safari is in the background. Go back to Safari and it restarts on its own.
• Port already in use: ggcam --port 8444.
• Your computer's IP address changed: delete the certificate folder shown when ggcam starts, then start it again.

To uninstall: npm uninstall -g @ourssympa/ggcam.

Français

Tu as une bonne caméra mais plus d'espace sur ton téléphone ? Utilise-le comme caméra : l'image et le son sont transmis en direct à ton ordinateur, et tes vidéos sont enregistrées sur le disque de l'ordinateur.

Et ce n'est pas tout : tu as aussi un retour d'image sur grand écran pour cadrer pendant que tu filmes ton contenu. Plus besoin d'installer une application ni de chercher des solutions compliquées.

Installer (une seule fois)

1. Installe Node.js (version « LTS ») depuis nodejs.org.

2. Ouvre un terminal (sous Windows : PowerShell, ou WSL si Node.js est aussi installé sous Windows) et tape :

   npm install -g @ourssympa/ggcam

Lancer

Dans un terminal, depuis n'importe quel dossier :

ggcam

Le navigateur s'ouvre sur https://localhost:8443 (tout seul sous Windows ; sur les autres systèmes, ouvre cette adresse toi-même).

La première fois :

• Le navigateur prévient que la connexion n'est pas privée. C'est normal (le certificat est créé sur ton ordinateur) : clique sur Paramètres avancés, puis Continuer.
• Windows demande si Node.js peut utiliser le réseau : coche Réseaux privés et valide.

Filmer

1. Connecte le téléphone et l'ordinateur au même Wi-Fi.
2. Scanne le QR code affiché sur l'ordinateur avec l'appareil photo du téléphone.
3. Safari affiche « Cette connexion n'est pas privée » : touche Afficher les détails › visiter ce site web › Visiter le site web. Il ne le demande qu'une fois.
4. Touche Démarrer la caméra, puis autorise la caméra et le micro.
5. L'image s'affiche sur l'ordinateur. Clique sur le bouton d'enregistrement (ou appuie sur R). À l'arrêt, la vidéo est enregistrée dans le dossier Téléchargements de l'ordinateur.

Sur l'ordinateur : F plein écran, M son, R enregistrer. Sur le téléphone : changer d'objectif, choisir 720p ou 1080p, et toucher le bouton rouge pour enregistrer — il demande si l'enregistrement doit se faire sur le téléphone ou sur le PC, ce qui permet de lancer celui du PC sans quitter son cadrage.

En cas de problème

• Le téléphone n'arrive pas à ouvrir la page : vérifie que les deux appareils sont sur le même Wi-Fi et que l'adresse choisie sous le QR code est celle du Wi-Fi (ex. 192.168.1.x). Dans Windows, déclare ton Wi-Fi en réseau Privé et autorise Node.js dans le pare-feu.
• La page s'ouvre mais l'image ne vient pas : désactive le VPN de l'ordinateur s'il y en a un. Les Wi-Fi « invités » ou publics empêchent souvent les appareils de communiquer entre eux : utilise ton Wi-Fi perso ou le partage de connexion du téléphone.
• Caméra refusée : sur l'iPhone, Réglages › Safari › Caméra / Micro › Autoriser, puis recharge la page.
• L'image se fige quand tu changes d'appli : iOS coupe la caméra quand Safari passe en arrière-plan. Reviens sur Safari, elle se relance toute seule.
• Port déjà utilisé : ggcam --port 8444.
• L'adresse IP de l'ordinateur a changé : supprime le dossier du certificat affiché au lancement de ggcam, puis relance.

Pour désinstaller : npm uninstall -g @ourssympa/ggcam.