Skip to content
This repository has been archived by the owner on Jul 25, 2022. It is now read-only.

Nowaaru/suwariyomi

Repository files navigation

yeah this got archived

don't ever use electron-react-boilerplate

ever.

please.

座り読み

old stuff | issues | forks | stars | license | codefactor | share | | --------------------------------------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | | | | | CodeFactor | |

similarly to Tachiyomi, suwariyomi is a free and open-source manga reader for windows, mac, and linux.

this application is incomplete. some features are bound to change; and some could be removed entirely.

downloads

downloads are available here.

found a bug or problem? make an issue!

features

user features:

  • online reading from one source. it is mangadex.
  • tracker support: MyAnimeList and AniList. more soon to come!
  • image filtering with alpha, red, green, blue and blend modes.
  • very pretty UI
  • very nice UX
  • very responsive! (laymans: faaaast)
  • lots of settings for you to customize your app just right
  • ability copy pages to the clipboard when reading via the context menu
  • ability to download individual pages when reading via the context menu
  • its all in dark mode

developer features:

  • modular sources
  • very segmented for easy understanding
  • the code is pretty
  • made in react
  • easy-to-make sources
  • utilizes Aphrodite for styling
  • utilizes Material UI for ui design

planned features:

  • online reading from all the sources.
  • support Kitsu, Shikimori, and Bangumi similarly to Tachiyomi
  • library organization via categories
  • custom themes; hopefully a theme repository!
  • plugins to further extend user experience
  • downloading

in short, i aim to accomplish what Tachiyomi can do and then some.

styling

work in progress!
all pages have a series of dummy stylings that allow you to change the general format of the page: these stylings look something among the lines of
  • ...Container
  • ...Inner

with enough experience, this alone gives you enough experience to create an entirely different look and feel of the app, you could even say that you're essentially making your own application at that rate!

you can also style already-existing elements if you so desire. anything that i style is what you can style!

"how do i contribute?"

as you know, doing everything alone all the time is unrealistic. suwariyomi endeavors to be a community-driven application; those who want something to be implemented can implement it themselves with ease and in order to generate that ease, people have to point out flaws in the application; so get to making issues and pull requests!

if you are comitting...

follow these guidelines!
(some things might not be applicable)
  • please make sure that your code is clear and concise.

    • if you disable linter rules, give an explanation why! it doesn't need to be an essay, but a short reason, i.e. 'Module is typed incorrectly.' is preferable.
  • if your code can be abstracted into a component, please do so!

    • a page should be a list of components. if a page itself is starting to look like a component, maybe you should start to do some splicing!
  • use comments when it gets rough!

    • sometimes you'd have the occasional nested ternary or a snippet of code that simply looks weird or might go against standard. if something might be hard to understand to an intermediate or novice programmer, you probably want to use a comment.
  • when updating pages or implementing components, give everything a style!

    • this is to ensure that everything can be styled to the user's liking in case we make a design choice that might not be for everyone's liking.
  • if you are commenting or proposing changes to a PR, be respectful and clearly state your gripe.

    • being rude or passive-aggressive does nothing to help; all it does is brew unwanted argument. if you are unable to successfully follow this guideline, you will be blocked from collaborating in this repository. be kind!

if you are making an issue...

follow these guidelines!
(some things might not be applicable)
  • make sure your issue is in the right spot!
    • if you're looking to report an issue or suggest a feature for an extension, we don't do that here! you should instead check the extensions repository instead of looking here.
  • tag your issue correctly!
    • this allows us to focus on specific things at specific times and allows us to designate varying severities and other auxiliary tags to help production.
  • if you're making a feature request, be clear and concise; as if you're coding.
    • we don't want to misinterpret what you say and close your issue despite it being a valid or necessary addition to the app. be clear!
  • if you're reporting a bug, once again, be clear and concise.
    • give us as much information as possible, treat us as if we're babies! if we can't reproduce something after a handful of attempts, we'll mark it as invalid and close it. to reduce room for error, tell us everything!
    • if you have a clue as to why this might be happening, let us know! it doesn't matter whether you're wrong or not, it would at least narrow down what the issue could possibly be. everyone is knowledgeable! 😁

how to build

clone the repository and install the dependencies:
git clone --depth 1 --branch main https://github.com/Nowaaru/suwariyomi.git <your project name>

navigate into your new folder (if you didn't clone in the current directory) and run npm install.

cd <your project name>
npm install

to test the program, run npm start. if you have a port conflict, change the port in .erb/scripts/check-port-in-use.js (or figure out command line args in node)

About

A manga reader inspired by Tachiyomi; made in Electron, for Windows, Mac, and Linux.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published