Giter VIP home page Giter VIP logo

kotatsu-syncserver's Introduction

Kotatsu Synchronization Server

Kotatsu is a free and open source manga reader for Android platform. Supports a lot of online catalogues on different languages with filters and search, offline reading from local storage, favourites, bookmarks, new chapters notifications and more features.

List of official servers:

Domain Location Status
sync.kotatsu.app Belarus Uptime

What is synchronization?

Synchronization is needed to store your collection of favorites, history and categories and have remote access to them. On a synchronized device, you can restore your manga collection in real time without loss. It also supports working across multiple devices. It is convenient for those who use several devices.

How does synchronization work?

  • An account is created and configured in the application where it will store data;
  • Synchronization starts. The data selected by the user is saved on the service and stored there under protection;
  • Another device connects and syncs with the service;
  • The uploaded data appears on the device connected to the account.

What data can be synchronized?

  • Favorites (with categories);
  • History.

How do I sync my data?

Go to Options -> Settings -> Services, then select Synchronization. Enter your email address (even if you have not registered in the synchronization system, the authorization screen also acts as a registration screen), then come up with and enter a password.

ATTENTION: there is no password recovery from the account at the moment,
if you forget the password, you will not be able to log into your account on other 
devices, so we recommend that you do not forget the password or write it down somewhere. 

After the authorization/registration process, you will return back to the Content screen. To set up synchronization, select Synchronization again, and then you will go to system sync settings. Choose what you want to sync, history, favorites or all together, after which automatic synchronization to our server will begin.

Can I use a synchronization server on my hosting?

Yes, you can use your synchronization server in the application by specifying its address (Options -> Settings -> Services -> Synchronization settings -> Server address). Instructions for deploying the server are below.

Installation

Docker

Build image container:

docker build github.com/KotatsuApp/kotatsu-syncserver.git -t kotatsuapp/syncserver

Run container:

docker run -d -p 8081:8080 \
-e DATABASE_HOST=your_db_host \
-e DATABASE_USER=your_db_user \
-e DATABASE_PASSWORD=your_db_password \
-e DATABASE_NAME=your_db_name \
-e DATABASE_PORT=your_db_port \
-e JWT_SECRET=your_secret \
--restart always \
--name kotatsu-sync kotatsuapp/syncserver

Systemd

Requirements:

  • JDK 11+
  • Gradle 7.0+

Commands:

$ git clone https://github.com/KotatsuApp/kotatsu-syncserver.git
$ cd kotatsu-syncserver && ./gradlew shadowJar

Then edit file kotatsu-sync.service, change replaceme fields with your values and specify the kotatsu-syncserver-0.0.1.jar file location (it can be found in build/libs directory after buliding)

$ cp kotatsu-sync.service /etc/systemd/system
$ systemctl enable kotatsu-sync
$ systemctl daemon-reload
$ systemctl start kotatsu-sync

That's all :) For any questions, please, contact us in Telegram group or write an issue, thanks.

License

GNU GPLv3 Image

You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.

kotatsu-syncserver's People

Contributors

koitharu avatar ztimms73 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.