neko

<div align="center">
  <a href="https://github.com/m1k1o/neko" title="Repository Github di Neko.">
    <img src="https://assets.kitploit.com/production/public/readmes/12372/d615c7dc035ac347a0b04287c4f689d36878442142b42156e3781c3c96186a4c.png" width="400" height="auto"/>
  </a>
  <p align="center">
    <a href="https://github.com/m1k1o/neko/releases">
      <img src="https://img.shields.io/github/v/release/m1k1o/neko" alt="release">
    </a>
    <a href="https://github.com/m1k1o/neko/blob/master/LICENSE">
      <img src="https://img.shields.io/github/license/m1k1o/neko" alt="license">
    </a>
    <a href="https://hub.docker.com/r/m1k1o/neko">
      <img src="https://img.shields.io/docker/pulls/m1k1o/neko" alt="pulls">
    </a>
    <a href="https://github.com/m1k1o/neko/issues">
      <img src="https://img.shields.io/github/issues/m1k1o/neko" alt="issues">
    </a>
    <a href="https://github.com/sponsors/m1k1o">
      <img src="https://img.shields.io/badge/-sponsor-red" alt="issues">
    </a>
    <a href="https://discord.gg/HXQJmqNJMz">
      <img src="https://assets.kitploit.com/production/public/readmes/12372/f6cb90bffba6aa52dffaaae26d46a18d1fb514e8d1411a80dce96df2fa46a6ec.png" alt="Chat on discord">
    </a>
    <a href="https://hellogithub.com/repository/4536d4546af24196af3f08a023dfa007" target="_blank">
      <img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=4536d4546af24196af3f08a023dfa007&amp;claim_uid=0x19e4dJwD83aW2&amp;theme=small" alt="Featured｜HelloGitHub" />
    </a>
    <a href="https://github.com/m1k1o/neko/actions">
      <img src="https://github.com/m1k1o/neko/actions/workflows/ghcr.yml/badge.svg" alt="build">
    </a>
  </p>
  <img src="https://assets.kitploit.com/production/public/readmes/12372/c85b494a39869005a0d9f5c65ffcaf1fa002defafe4c0e01f339b9f51e4e4caf.gif" width="650" height="auto"/>
</div>

# n.eko

Benvenuto in Neko, un browser virtuale self-hosted che gira in Docker e utilizza la tecnologia WebRTC. Neko è un potente strumento che ti permette di **eseguire un browser completamente funzionante in un ambiente virtuale**, dandoti la possibilità di **accedere a Internet in modo sicuro e privato da qualsiasi luogo**. Con Neko puoi navigare sul web, **eseguire applicazioni** e svolgere altre attività proprio come faresti con un browser normale, tutto all'interno di un **ambiente sicuro e isolato**. Che tu sia uno sviluppatore che desidera testare applicazioni web, un **utente attento alla privacy che cerca un'esperienza di navigazione sicura**, o semplicemente qualcuno che vuole sfruttare la **comodità e la flessibilità di un browser virtuale**, Neko è la soluzione perfetta.

Oltre alle sue caratteristiche di sicurezza e privacy, Neko offre la **possibilità a più utenti di accedervi contemporaneamente**. Questo lo rende una soluzione ideale per team o organizzazioni che devono condividere l'accesso a un browser, così come per individui che vogliono utilizzare **più dispositivi per accedere allo stesso ambiente virtuale**. Con Neko puoi **condividere facilmente e in modo sicuro l'accesso a un browser con altri**, senza doverti preoccupare di mantenere configurazioni o impostazioni separate. Che tu abbia bisogno di **collaborare a un progetto**, accedere a risorse condivise, o semplicemente **condividere l'accesso a un browser con amici o familiari**, Neko rende tutto semplice.

Neko è anche un ottimo strumento per **ospitare watch party** e presentazioni interattive. Grazie alle sue capacità di browser virtuale, Neko ti permette di ospitare watch party e presentazioni **accessibili da qualsiasi luogo**, senza la necessità di incontri di persona. Questo rende facile **rimanere in contatto con amici e colleghi**, anche quando non puoi incontrarti di persona. Con Neko puoi facilmente organizzare un watch party o tenere una **presentazione interattiva**, sia per svago che per lavoro. Basta invitare i tuoi ospiti a unirsi all'ambiente virtuale e puoi condividere lo schermo e **interagire con loro in tempo reale**.

## Informazioni

Questa applicazione usa WebRTC per trasmettere in streaming un desktop all'interno di un container Docker; l'autore originale l'ha creata perché [rabb.it](https://en.wikipedia.org/wiki/Rabb.it) è stato chiuso e la sua connessione internet non riusciva a gestire lo streaming, mentre Discord continuava a crashare quando il suo amico tentava di usarlo. Voleva solo guardare anime con i suoi amici ლ(ಠ益ಠლ), così ha iniziato a cercare su internet e ha trovato alcuni cloni *abbastanza* simili, ma nessuno di questi aveva il browser virtuale; poi ha trovato [Turtus](https://github.com/Khauri/Turtus) e ha potuto completare il lavoro.

Poi ho trovato [questo](https://github.com/nurdism/neko) progetto e ho iniziato a esplorarlo. Mi è piaciuta molto l'idea di navigare insieme a più persone in modo collaborativo, così ho creato un fork. Inizialmente volevo unire le mie modifiche al repository upstream, ma l'autore originale non aveva più tempo per questo progetto e alla fine è stato archiviato.

## Casi d'uso e confronto

Neko è nato come browser virtuale trasmesso in streaming tramite WebRTC a più utenti.
- **Non è limitato solo a un browser**; può eseguire qualsiasi cosa funzioni su linux (es. VLC). Il browser è solo il caso d'uso più popolare e diffuso.
- In effetti, non è limitato nemmeno a un singolo programma; puoi installare un ambiente desktop completo (es. XFCE, KDE).
- A proposito di limiti, non è necessario che giri in un container; puoi installare neko sul tuo host, connetterti al tuo server X e controllare l'intera VM.
- Teoricamente non è limitato solo al server X; qualsiasi cosa che possa essere controllata e periodicamente analizzata per ottenere immagini potrebbe essere utilizzata.
  - Come implementare il protocollo RDP o VNC, dove neko agirebbe solo come relay WebRTC. Questo è attualmente solo un progetto futuro.

Il caso d'uso principale è connettersi con più persone, sfruttando la sincronizzazione e l'interattività in tempo reale:
- **Watch party** - guardare contenuti video insieme a più persone e reagire (chat, emote) - alternativa open source a [giggl.app](https://giggl.app/) o [hyperbeam](https://watch.hyperbeam.com).
- **Presentazione interattiva** - non solo condivisione dello schermo, ma altri possono controllare lo schermo.
- **Strumento collaborativo** - brainstorming di idee, navigazione condivisa, debugging del codice insieme.
- **Supporto/Didattica** - guidare le persone in modo interattivo in un ambiente controllato.
- **Integra qualsiasi cosa** - integra un browser virtuale nella tua app web - alternativa open source a [hyperbeam API](https://hyperbeam.com/).
  - apri qualsiasi sito web o applicazione di terze parti, sincronizza audio e video perfettamente tra più partecipanti.
  - richiedi stanze tramite API con [neko-rooms](https://github.com/m1k1o/neko-rooms).
- [**Neko dentro VR Chat**](https://github.com/jameskitt616/vrchat_streaming) - guarda un browser remoto insieme agli amici in VR.

Altri casi d'uso che beneficiano di un singolo utente:
- **Spazio di lavoro personale** - streaming di app e desktop containerizzati agli utenti finali - simile a [kasm](https://www.kasmweb.com/).
- **Browser persistente** - browser personale con cookie persistenti disponibile ovunque - simile a [mightyapp](https://www.mightyapp.com/).
  - nessuno stato rimane nel browser host dopo aver terminato la connessione.
  - i dati sensibili come i cookie non vengono trasferiti - viene condiviso solo il video.
- **Browser usa e getta** - una soluzione migliore per organizzare feste segrete e acquistare regali di compleanno su internet.
  - usa Tor Browser e [VPN](https://github.com/m1k1o/neko-vpn) per un ulteriore anonimato.
  - mitiga il rischio di fingerprinting del sistema operativo e vulnerabilità del browser eseguendo in un container.
- **Trasmissione della sessione** - trasmetti il contenuto della stanza tramite RTMP (es. su twitch o youtube...).
- **Registrazione della sessione** - RTMP trasmesso può essere salvato in un file usando ad es. [nginx-rtmp](https://www.nginx.com/products/nginx/modules/rtmp-media-streaming/)
  - avere un ambiente pulito durante la registrazione di tutorial.
  - non c'è bisogno di nascondere i segnalibri o usare la modalità incognito.
- **Host di salto** - accedi in modo sicuro alle tue applicazioni interne senza bisogno di VPN.
- **Browser automatizzato** - puoi installare [playwright](https://playwright.dev/) o [puppeteer](https://pptr.dev/) e automatizzare le attività mentre puoi intercettarle attivamente.

Rispetto a un gateway desktop remoto senza client (es. [Apache Guacamole](https://guacamole.apache.org/) o [websockify](https://github.com/novnc/websockify) con [noVNC](https://novnc.com/)), installato con un server desktop remoto insieme al programma desiderato (es. [linuxserver/firefox](https://docs.linuxserver.io/images/docker-firefox)) fornisce a neko ulteriori funzionalità:
- **Video fluido** perché utilizza WebRTC e non immagini inviate tramite WebSocket.
- **Supporto audio integrato**, cosa che non fa parte di Apache Guacamole o noVNC.
- **Controllo multi-partecipante**, non supportato nativamente da Apache Guacamole o noVNC.

### Browser supportati

<div align="center">
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#firefox">
    <img src="https://neko.m1k1o.net/img/icons/firefox.svg" title="ghcr.io/m1k1o/neko/firefox" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#tor-browser">
    <img src="https://neko.m1k1o.net/img/icons/tor-browser.svg" title="ghcr.io/m1k1o/neko/tor-browser" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#waterfox">
    <img src="https://neko.m1k1o.net/img/icons/waterfox.svg" title="ghcr.io/m1k1o/neko/waterfox" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#chromium">
    <img src="https://neko.m1k1o.net/img/icons/chromium.svg" title="ghcr.io/m1k1o/neko/chromium" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#google-chrome">
    <img src="https://neko.m1k1o.net/img/icons/google-chrome.svg" title="ghcr.io/m1k1o/neko/google-chrome" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#ungoogled-chromium">
    <img src="https://neko.m1k1o.net/img/icons/ungoogled-chromium.svg" title="ghcr.io/m1k1o/neko/google-chrome" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#microsoft-edge">
    <img src="https://neko.m1k1o.net/img/icons/microsoft-edge.svg" title="ghcr.io/m1k1o/neko/microsoft-edge" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#brave">
    <img src="https://neko.m1k1o.net/img/icons/brave.svg" title="ghcr.io/m1k1o/neko/brave" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#vivaldi">
    <img src="https://neko.m1k1o.net/img/icons/vivaldi.svg" title="ghcr.io/m1k1o/neko/vivaldi" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#opera">
    <img src="https://neko.m1k1o.net/img/icons/opera.svg" title="ghcr.io/m1k1o/neko/opera" width="60" height="auto"/>
  </a>

  ... vedi [tutte le immagini disponibili](https://neko.m1k1o.net/docs/v3/installation/docker-images)
</div>

### Altre applicazioni

<div align="center">
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#xfce">
    <img src="https://neko.m1k1o.net/img/icons/xfce.svg" title="ghcr.io/m1k1o/neko/xfce" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#kde">
    <img src="https://neko.m1k1o.net/img/icons/kde.svg" title="ghcr.io/m1k1o/neko/kde" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#remmina">
    <img src="https://neko.m1k1o.net/img/icons/remmina.svg" title="ghcr.io/m1k1o/neko/remmina" width="60" height="auto"/>
  </a>
  <a href="https://neko.m1k1o.net/docs/v3/installation/docker-images#vlc">
    <img src="https://neko.m1k1o.net/img/icons/vlc.svg" title="ghcr.io/m1k1o/neko/vlc" width="60" height="auto"/>
  </a>

  ... altri in <a href="https://github.com/m1k1o/neko-apps">m1k1o/neko-apps</a>
</div>

### Perché neko?

Mi piacciono i gatti 🐱 (`Neko` è la parola giapponese per gatto), sono uno *weeb*/nerd.

***Ma perché il didietro di gatto?*** Perché i gatti sono *stronzi*, ma li ami comunque.

## Stanze multiple

Per il software di gestione delle stanze di neko, visita [neko-rooms](https://github.com/m1k1o/neko-rooms).

Offre anche [installazione a conoscenza zero (con HTTPS)](https://github.com/m1k1o/neko-rooms/?tab=readme-ov-file#zero-knowledge-installation-with-https).

## Documentazione

La documentazione completa è disponibile su [neko.m1k1o.net](https://neko.m1k1o.net/). Sezioni principali:

- [Migrazione da V2](https://neko.m1k1o.net/docs/v3/migration-from-v2)
- [Per iniziare](https://neko.m1k1o.net/docs/v3/quick-start)
- [Installazione](https://neko.m1k1o.net/docs/v3/installation)
- [Esempi](https://neko.m1k1o.net/docs/v3/installation/examples)
- [Configurazione](https://neko.m1k1o.net/docs/v3/configuration)
- [Domande frequenti](https://neko.m1k1o.net/docs/v3/faq)
- [Risoluzione dei problemi](https://neko.m1k1o.net/docs/v3/troubleshooting)

## Come contribuire

I contributi sono benvenuti! Consulta la [Guida per contribuire](https://neko.m1k1o.net/contributing) per i dettagli.

## Supporto

Se trovi Neko utile, considera di supportare il progetto tramite [GitHub Sponsors](https://github.com/sponsors/m1k1o).