toto04 / webeep-sync

Keep all your WeBeep files synced on your computer!
GNU General Public License v3.0
55 stars 6 forks source link
electron macos polimi typescript webeep windows

GitHub GitHub package.json version GitHub all releases GitHub release (latest by date) donate

🇬🇧 click here for English version

WeBeep Sync è una semplice app che serve per tenere sincronizzati tutti i tuoi file di WeBeep, User-Friendly e senza compromessi.

Sto sviluppando quest'app come strumento ad uso personale, ma ho pensato potesse essere utile ad altri studenti, perciò è completamente opensource e gratuita sotto licenza GPLv3.

Cos'è esattamente?

WeBeep Sync stata pensata come un sostituto a PoliBeepSync visto che non sarebbe stato aggiunto il supporto per WeBeep. Punta a essere una soluzione più user-firendly, completa e definitiva di Moodle Downloader 2, il mio obiettivo era di avere qualcosa che puoi scaricare e dimenticartene, essendo sicuro che tutti i file di WeBeep saranno sempre aggiornati.

A cosa serve?

Proprio come PoliBeepSync, serve per tenere sincronizzati i propri file di WeBeep in una cartella locale sul proprio PC. Se vuoi un'esperienza senza pensieri, puoi lasciare che l'app si apra in background e puoi scegliere ogni quanto avverranno le sincronizzazioni, così da avere sempre tutti i file aggiornati. Oppure puoi disattivare l'autosync e scaricare tutti i file in una volta sola quando preferisci.

Download

Nelle release di Github puoi trovare l'app già impacchettata e pronta da usare per Windows e macOS (sia x64 che M1)

Ultima Release

Puoi usare i seguenti link per scaricare direttamente la versione più adatta a te

Windows

Installer x64

macOS

dmg x64 (Intel)

dmg arm64 (M1 o superiore)

"WeBeep Sync" è danneggiato e non può essere aperto. Come risolvere?

Per colpa del fatto che non ho un account da sviluppatore con cui firmare un certificato perché costa troppo, macOS considera il file come proveniente da uno sviluppatore non indentificato e blocca l'avvio.

Per ovviare a questa lieve inconvenienza, bisogna manualmente dare i permessi di esecuzioni all'app. Per fare ciò, una volta spostato WeBeep Sync nella cartella Applicazioni, apri il Terminale e incolla queto comando

sudo xattr -rd com.apple.quarantine /Applications/WeBeep\ Sync.app

e dovrebbe tutto funzionare senza problemi

Linux

.deb (Debian based, tipo Ubuntu)

.rpm (RedHat based, tipo Fedora)

Installazione manuale (istruzioni di compilazione)

Prerequisiti:

Per prima cosa scarica l'app

# clona la repository
git clone https://github.com/toto04/webeep-sync && cd webeep-sync
# installa le dependencies
yarn

e questo è tutto, l'app può essere avviata via linea di comando con

yarn start

oppure puoi creare un package per installarla con

yarn make

Per maggiori informazioni, dai un'occhiata agli script in package.json e alla documentazione della CLI di Electron Forge, dove puoi trovare istruzioni su come modificare il file forge.config.js a tuo gradimento per creare un package che fa al caso tuo

Informazioni sull'app

L'app è basata su Electron, scritta usando Typescript e React. È stata creata usando Electron Forge ed è pubblicata con la licenza GPLv3.

Se vuoi aiutare lo sviluppo dell'app proponendo bug-fixes o nuove feature, puoi aprire una issue.

Per qualsiasi altra informazione, spero che i commenti che ho lasciato in giro siano abbastanza chiari, altrimenti idk scrivimi un'email I guess.

Oppure se trovia particolarmente utile l'app, puoi offrirmi un caffè dondomi qualche spicciolo su PayPal (che magari così chissà che potrei anche arrivare a permettermi un account da sviluppatore Apple 🤷‍♂️)

Grazie mille 🥺❤️

Features

Ok ma cosa si scrive in fondo a un README? Cioè qualcuno legge anche fino in fondo? Ecco video di gattini come ricompensa per essere arrivato fin quaggiù: link


English Version:

donate

WeBeep Sync is a simple app that is used to keep all your WeBeep files synchronized, User-Friendly and uncompromising.

I'm developing this app as a tool for personal use, but I thought it might be useful to other students, so it's completely opensource and free under the GPLv3 license.

What is it exactly?

WeBeep Sync was intended as a replacement for PoliBeepSync since support for WeBeep would not be added. It aims to be a more user-firendly, complete and definitive solution than Moodle Downloader 2, my goal was to have something you can download and forget about, being sure that all the WeBeep files will be always up to date.

What is it for?

Just like PoliBeepSync, it serves to keep your WeBeep files synchronized in a local folder on your folder on your PC. If you want a worry-free experience, you can let the app open in the background and you can choose how often the synchronizations will take place, so you will always have all your files up to date. Or you can turn off autosync and download all your files at once when you like.

Downloads

In the Github releases you can find the app already packaged and ready to use for Windows and macOS (both x64 and M1)

Latest Release

You can use the following links to directly download the version that suits you best

Windows

Installer x64

macOS

dmg x64 (Intel)

dmg arm64 (M1 or higher)

"WeBeep Sync" is damaged and can't be opened. How to solve it?

Due to the fact that I don't have a developer account with which to sign a certificate because it cost too much, macOS considers the file as coming from an unidentified developer and blocks the startup.

To get around this minor inconvenience, you have to manually give the app execution permissions. To do this, once you've moved WeBeep Sync to the Applications folder, open the Terminal and paste this command

sudo xattr -rd com.apple.quarantine /Applications/WeBeep\ Sync.app

and everything should work without problems

Linux

.deb (Debian based, like Ubuntu)

.rpm (RedHat based, like Fedora)

Manual installation (compile instructions)

Prerequisites:

First of all, download the app

# clone the repository
git clone https://github.com/toto04/webeep-sync && cd webeep-sync
# install dependencies
yarn

and that's it, the app can be launched from command line using

yarn start

or if you prefer, you can create a package for installation with

yarn make

For more information, have a look at the scripts in package.json and the documentation of the CLI documentation for Electron Forge, where you can find instructions on how to modify the file forge.config.js to your liking to create a package that suits your needs

About the app

The app is based on Electron, written using Typescript and React. It was created using Electron Forge and is licensed under the GPLv3 license.

If you want to help the development of the app by proposing bug-fixes or new features, you can open an issue.

For any other information, I hope the comments I left around are clear enough, otherwise idk write me an email I guess.

Or if you find the app particularly useful, you can buy me a coffee and give me some change on PayPal (which maybe then who knows I might even get to afford an Apple developer account 🤷‍♂️)

Thank you very much 🥺❤️

Features

Ok but what is written at the bottom of a README? I mean does anyone read all the way to the bottom? Here is a video of kittens as a reward for getting this far: link