chitchatter

Chitchatter

_{Logo disediakan oleh @ramyashreeshetty}

Chitchatter adalah alat komunikasi gratis (seperti dalam harga dan kebebasan). Dirancang untuk menjadi cara paling sederhana untuk terhubung dengan orang lain secara pribadi dan aman, itu adalah:

• Sumber terbuka sepenuhnya (dilisensikan di bawah GPL V2)
• Peer-to-peer
  • Kapan pun memungkinkan, jika tidak, server Turn digunakan untuk memastikan koneksi rekan yang andal
• Enkripsi End-to-End (via WebRTC)
• Tdk kekal
  • Konten pesan tidak pernah bertahan untuk disk pada klien atau server
• Terdesentralisasi
  • Tidak ada server API. Semua yang diperlukan untuk Fungsi untuk Fungsi adalah ketersediaan GitHub untuk aset statis, dan webtorrent publik dan server estafet setrum/turn untuk membangun komunikasi peer-to-peer.
• Disematkan
• Mandiri

Chitchatter menggunakan vite. Jaringan yang aman dan sihir streaming tidak akan mungkin terjadi tanpa Trystero. Fungsionalitas transfer file ditenagai oleh secure-file-transfer .

Status

Cara menggunakannya

Buka https://chitchatter.im/ dan bergabunglah dengan kamar untuk mulai mengobrol dengan orang lain yang ada di kamar. Secara default, nama kamar adalah uuid acak yang dihasilkan sisi klien. Untuk berkomunikasi secara pribadi dengan seseorang, disarankan untuk bergabung dengan salah satu kamar yang dihasilkan secara acak ini dan berbagi URL (melalui tombol "?" Di bagian atas halaman) kepada siapa pun yang ingin Anda komunikasikan melalui media yang aman dari pilihan Anda (seperti Burner Note atau Yopass). Nama pengguna Anda akan disajikan kepada Anda, dan akan lebih baik untuk membagikannya dengan siapa Anda akan mengobrol sebelumnya sehingga mereka tahu mereka berbicara dengan Anda.

Fitur

• Beberapa rekan per kamar (hanya dibatasi oleh jumlah koneksi rekan yang didukung browser Anda).
• Kamar publik dan pribadi.
• Obrolan video dan audio.
• Berbagi Layar.
• Pesan Langsung.
• Berbagi File:
  • Transfer ukuran file tanpa batas.
  • File dienkripsi sebelum dikirim dan didekripsi oleh penerima (kuncinya adalah nama kamar).
• Menanamkan ke aplikasi web lain melalui iframe .
• Dukungan Markdown melalui react-markdown .
  • Termasuk dukungan untuk penyorotan kode sintaks.
• Percakapan yang ditimbulkan dari rekan -rekan ketika peserta baru bergabung.
• Dukungan pesan multiline (tahan shift dan tekan enter ).
• Tema gelap dan terang.
• Verifikasi rekan otomatis melalui kriptografi kunci publik sisi klien.

Anti-fitur

• Pesan tidak pernah bertahan untuk disk. Saat Anda meninggalkan ruang sebaya, pesan dibersihkan dari memori dan tidak dapat diambil.
• Chitchatter adalah aplikasi komunikasi sisi klien yang sepenuhnya. Ini menggunakan server webtorrent publik untuk membuat koneksi peer dan server estafet setrum/belok ketika koneksi peer-to-peer langsung tidak dapat dibuat, tetapi tidak ada server API yang cocok.
• Tidak ada analitik, pelacakan, atau telemetri dalam bentuk apa pun.
• Ini adalah proyek yang digerakkan oleh masyarakat dan tidak didanai yang tidak menghasilkan uang. Pengguna datang lebih dulu dan tidak ada pengaruh perusahaan atau kepentingan finansial yang terlibat.

Mengapa aplikasi obrolan lain?

Tidak ada kekurangan aplikasi obrolan ramah pengguna yang tersedia, tetapi mereka bergantung pada layanan pusat untuk memfasilitasi komunikasi. Sulit untuk mempercayai layanan pusat ini, karena kepentingan komersial dan tekanan pemerintah dapat memaksa operator layanan untuk bekerja melawan kepentingan terbaik pengguna. Bahkan ketika data pengguna ditangani dengan itikad baik oleh operator layanan, kemungkinan tetap bahwa data terenkripsi yang disimpan saat istirahat dapat didekripsi terhadap kehendak pengguna.

Desain Chitchatter di sekitar risiko ini dengan arsitektur web mesh. Tidak ada operator layanan sentral yang menyimpan atau berpotensi mish penanganan data komunikasi. Beberapa layanan diharuskan untuk membangun hubungan awal antara rekan, tetapi jika tidak, aplikasi menggunakan komunikasi peer-to-peer langsung untuk semuanya. Layanan apa pun yang digunakan oleh Chitchatter tidak memiliki hubungan dengan proyek dan tersedia untuk umum untuk semua digunakan.

Menggunakan kasus

Chitchatter menawarkan solusi pribadi dan aman untuk:

• Mengorganisir kelompok orang, seperti serikat atau gerakan politik
• Teks atau data yang memindahkan dengan mudah dari satu perangkat ke perangkat lainnya
• Obrolan video dengan teman dan keluarga di seluruh sistem operasi (seperti Android dan iOS)
• Ini memecahkan masalah melalui berbagi layar
• Streaming langsung
• Berbagi informasi sensitif seperti kata sandi
• Lebih banyak lagi!

---

Catatan dari pengembang

Status status proyek

Saya menganggap fitur-fitur-fitur-lengkap karena itu melakukan semua hal yang secara pribadi perlu saya lakukan. Saya tidak memiliki rencana khusus untuk menambahkan fungsionalitas yang signifikan di masa depan, tetapi saya dapat melakukannya jika tampaknya menyenangkan bagi saya saat itu. Saya berkomitmen untuk memperbaiki bug signifikan yang dilaporkan, jadi silakan buka masalah jika Anda menemukannya! Selain itu, Chitchatter secara efektif dalam mode pemeliharaan untuk masa mendatang.

Jika Anda ingin fitur diterapkan dan bersedia membayar biaya pengembangan untuk memastikannya dilakukan, silakan ajukan masalah github yang menggambarkan fitur tersebut dan tunjukkan bahwa Anda bersedia mengkompensasi pekerjaan tersebut. Jika Anda tidak mau membayar, buka masalah GitHub. Saya dapat mengimplementasikannya jika tampaknya menyenangkan untuk melakukannya, tetapi anggota masyarakat lain juga dapat melangkah untuk mengimplementasikannya melalui permintaan tarik.

Saya akan selalu membuat permintaan tarikan waktu dari orang lain. Jika Anda bersedia melakukan pekerjaan untuk meningkatkan chitchatter, saya bersedia membantu menggembalakan itu bekerja dan mengirimkannya.

Jika Anda tidak setuju dengan arah proyek, Anda dipersilakan untuk Fork Chitchatter dan mengambilnya di yang lain.

Dukungan dan Pengembangan Kustom

Saya bersedia melakukan instalasi berbayar dan penyesuaian chitchatter untuk kebutuhan Anda. Jika Anda ingin mengontrak saya untuk membuat versi chitchatter yang dibuat khusus untuk Anda, silakan email saya di [email protected] dan beri tahu saya apa yang Anda pikirkan untuk memulai.

---

Kebenaran

Inti dari model keamanan Chitchatter adalah kenyataan bahwa itu sepenuhnya open source. Anda bebas (dan didorong) untuk sepenuhnya mengaudit kode sumber proyek dan infrastruktur. Tidak hanya kode sumber yang tersedia di bawah ketentuan GPL, tetapi semua log build juga dapat diakses publik.

Jika Anda ingin memverifikasi bahwa aplikasi yang di -host di https://chitchatter.im/ adalah yang di -host di GitHub, Anda dapat menggunakan dig :

 $ dig chitchatter.im

; <<>> DiG 9.18.1-1ubuntu1.1-Ubuntu <<>> chitchatter.im
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 61332
;; flags: qr rd ra; QUERY: 1, ANSWER: 5, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 65494
;; QUESTION SECTION:
;chitchatter.im.                        IN      A

;; ANSWER SECTION:
chitchatter.im.         231     IN      CNAME   jeremyckahn.github.io.
jeremyckahn.github.io.  231     IN      A       185.199.111.153
jeremyckahn.github.io.  231     IN      A       185.199.110.153
jeremyckahn.github.io.  231     IN      A       185.199.109.153
jeremyckahn.github.io.  231     IN      A       185.199.108.153

Untuk memeriksa aset statis yang disajikan untuk pengguna akhir, Anda dapat mengaudit cabang gh-pages .

Peta Jalan Proyek

Lihat backlog tiket lengkap di sini.

Lingkungan

• Lingkungan Produksi: https://chitchatter.im/
  • Mirror: https://chitchatter.vercel.app/ (Perhatikan bahwa rekan tidak dapat terhubung di seluruh domain)
• Pementasan: https://chitchatter-git-develop-jeremyckahn.vercel.app/

SDK

Anda dapat menggunakan SDK Chitchatter resmi untuk menyematkan aplikasi sebagai komponen web yang disebut <chat-room /> .

 < script src =" https://chitchatter.im/sdk.js " > </ script >

< chat-room />

Komponen <chat-room /> mendukung atribut opsional berikut:

• room : Nama kamar comtatter yang harus bergabung dengan pengguna. Nilai default adalah URL dari halaman embedding.
• user-name : Nama ramah pengguna (yang dapat mereka ubah).
• user-id : ID statis pengguna. Nilai default adalah UUID acak.
• root-url : URL instance chitchatter untuk digunakan. Nilai defaultnya adalah https://chitchatter.im/ .
• color-mode : light atau dark . Nilai defaultnya dark .
• play-message-sound : Apakah akan memainkan suara atau tidak ketika pengguna menerima pesan saat jendela tidak fokus. Nilai defaultnya false .

Serta standar <iframe /> atribut berikut:

• height
• width
• style
• referrerpolicy
• sandbox

Mengembangkan chitchatter

Penting

Saat ini Chitchatter hanya dapat dikembangkan pada sistem *NIX seperti Linux dan MacOS. Jika Anda menggunakan Windows, Anda dapat menggunakan WSL untuk mengatur lingkungan Linux.

Untuk membuat perubahan pada Chitchatter, klon kode sumber dari GitHub. Pastikan Anda menginstal Node dan NPM. Kemudian di direktori proyek, jalankan:

 npm install

Ini akan menginstal semua dependensi.

Skrip yang tersedia

Di direktori proyek, Anda dapat menjalankan:

npm dev

Menjalankan seluruh tumpukan (klien + pelacak webtorrent) secara lokal.

npm start

Menjalankan aplikasi ujung depan dalam mode pengembangan. Menggunakan pelacak webtorrent publik. Buka http: // localhost: 3000 untuk melihatnya di browser Anda.

Halaman akan memuat ulang saat Anda melakukan perubahan. Anda juga dapat melihat kesalahan serat di konsol.

npm test

Meluncurkan test runner dalam mode jam tangan interaktif.

npm run build

Membangun aplikasi untuk diproduksi ke folder dist . Bundelnya dengan benar bereaksi dalam mode produksi dan mengoptimalkan build untuk kinerja terbaik.

Bangunan diminifikasi dan nama file termasuk hash.

Tuan rumah mandiri

Chitchatter dirancang untuk bercabang dan diselenggarakan sendiri. Jika Anda ingin mengubah konfigurasi server berpasangan atau menyampaikan atau Anda lebih suka mengontrol bangunan dan versi Anda sendiri, garpu repo ini dan ikuti langkah -langkah di bawah ini.

Penting

Koneksi peer chitchatter terikat pada domain instance. Jadi, pengguna Chitchatter di https://chitchatter.im/ tidak akan dapat terhubung ke pengguna instance chitchatter di domain lain (seperti garpu halaman gitub-github pribadi).

Langkah -langkah yang diperlukan setelah bercabang

Dengan asumsi Anda hosting chitchatter di halaman gitub:

1. Ubah properti homepage di package.json ke url apa pun contoh cengkeraman Anda akan di -host. Ini akan menjadi sesuatu seperti https://github_user_or_org_name.github.io/chitchatter/ .
2. Tentukan DEPLOY_KEY Github Action Secret (di https://github.com/github_user_or_org_name/chitchatter/settings/secrets/actions ). Lihat Docs for peaceiris/actions-gh-pages untuk informasi lebih lanjut.
3. Jika Anda menggunakan halaman GitHub tanpa domain khusus, Anda harus mendefinisikan nama repo sebagai properti base di vite.config.ts . Berikut adalah contoh penampilannya:

 const config = ( ) => {
   return defineConfig ( {
      base : '/chitchatter/' ,
      build : {
       ...
} 

Penyebaran

Di GitHub

Ketika di -host di halaman GitHub dan konfigurasi di atas telah dilakukan, lingkungan produksi diperbarui ketika cabang main jarak jauh diperbarui (setelah tindakan github diaktifkan).

Pada host non-gitub

Bangun aplikasi dengan npm run build , lalu sajikan direktori dist . Solusi penyajian file statis apa pun harus berfungsi asalkan menggunakan konteks yang aman.

Konfigurasi Runtime

Jelajahi file di src/config untuk memodifikasi konfigurasi server pemasangan dan relay.

Kustomisasi tema

Chitchatter memanfaatkan pustaka komponen MUI yang dapat ditarik. Anda dapat menyesuaikan tampilan dan rasakan Chitchatter dengan memodifikasi definisi tema shell.

Pemecahan masalah

Jika Anda mengalami masalah apa pun dengan instalasi kustom chitchatter, pertama -tama pastikan Anda menggunakan versi kode terbaru. Jika Anda menjadi hosting instalasi Anda dengan halaman github, sinkronkan cabang main Anda dan bukan cabang gh-pages Anda. Memperbarui cabang main Anda akan memicu pembangunan kembali yang tepat dari cabang gh-pages Anda.

• https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork

Peers tidak akan terhubung

Ini bisa terjadi karena berbagai alasan. Yang paling mungkin adalah bahwa satu atau lebih rekan tidak dapat terhubung secara langsung dan harus menggunakan relai setrum/belokan yang dikonfigurasi sebagai fallback. Relai standar gratis dan tidak menjamin tingkat layanan apa pun, jadi mungkin tidak tersedia untuk beberapa waktu (atau tidak berfungsi sama sekali untuk beberapa pengguna). Tidak banyak yang bisa dilakukan selain menunggu sampai tersedia lagi, atau mungkin mencoba dari perangkat atau lokasi lain.

Masalah khusus untuk browser dengan ekstensi pemblokiran iklan

Beberapa blocker iklan (seperti asal usul ublock) mencegah koneksi ke server webtorrent tertentu. Ini mencegah rekan -rekan yang bodoh untuk menghubungkan. Untuk mengatasi hal ini, Anda dapat menonaktifkan pemblokir iklan Anda atau tuan rumah mandiri Anda sendiri.

Masalah khusus untuk safari iOS

Chitchatter bekerja di iOS Safari, tetapi bug tingkat browser sering mencegah rekan-rekan bergabung kembali dengan ruangan ketika browser ditutup dan kemudian dibuka kembali (misalnya, saat beralih aplikasi). Solusi yang disarankan untuk masalah ini adalah menyegarkan halaman untuk bergabung kembali dengan ruangan.

Masalah khusus untuk firefox

Per #36, periksa about:config Pengaturan dan pastikan bahwa media.peerconnection.enabled diaktifkan .

File yang ditawarkan tidak dapat diunduh dari teman sebaya

Chitchatter menggunakan streamsaver.js untuk memfasilitasi transfer file besar. Manajer unduhan seperti FDM diketahui mengganggu streamsaver.js, sehingga disarankan untuk menonaktifkan manajer unduhan tersebut ketika mencoba menerima file.

Keamanan

Chitchatter mengalami audit keamanan mingguan untuk mengidentifikasi dan mengatasi potensi kerentanan. Laporan dari semua audit dapat ditemukan dalam masalah .

Kontributor

️ Penafian

Dengan menggunakan Chitchatter, Anda setuju untuk menerima tanggung jawab penuh atas tindakan Anda yang terkait dengan penggunaannya. Selain itu, Anda setuju untuk tidak memiliki kontributor apa pun pada proyek Chitchatter yang bertanggung jawab atas hasil penggunaannya. Pengembang Chitchatter tidak mendukung aktivitas ilegal.