kami icon indicating copy to clipboard operation
kami copied to clipboard

A ln scraper to read light novels and watch anime in your terminal (Written in rust)

#+title: Readme #+OPTIONS: toc:2

  • Table of content
  1. [[#IMPORTANT][IMPORTANT]]
  2. [[#Why-use-kami][Why use kami]]
  3. [[#Dependencies][Dependencies]]
  4. [[#Install][Install]]
    • [[#LinuxMac][Linux/mac]]
    • [[#Windows][Windows]]
  5. [[#Honorable-mentions][Honorable mentions]]
  • IMPORTANT remove all contents of ~$HOME/.config/kami/an_progress.json~ new version is not compatibal with old progress file.
  • Why use kami Well its a fast and easy way to watch anime and read light novels right in your terminal no need to open a browser. Also rust is fast as fuck boiiiii. It can keep your anime tracking up to date with anilist.
  • Dependencies
  1. [[https://github.com/sharkdp/bat][bat]]
  2. [[https://mpv.io/][mpv]]
  3. [[https://git-scm.com/][gitbash]](if on windows) I will be explaining how to install them.
  • Install ** Linux/Mac
  1. install bat and mpv with your package manager(homebrew if on mac)
  2. Clone the repo for kami. #+begin_src shell git clone https://github.com/mrfluffy-dev/kami.git && cd kami #+end_src
  3. install [[https://www.rust-lang.org/tools/install][Rust]]
  4. Build kami using cargo. #+begin_src shell cargo build --release #+end_src
  5. Copy kami to your path. #+begin_src shell cp target/release/kami /usr/local/bin/kami #+end_src ** Windows
  6. install scoop #+begin_src shell Set-ExecutionPolicy RemoteSigned -Scope CurrentUser irm get.scoop.sh | iex #+end_src
  7. install git #+begin_src shell scoop install git #+end_src
  8. install mpv #+begin_src shell scoop bucket add extras scoop install mpv #+end_src
  9. install bat #+begin_src shell scoop install bat #+end_src
  10. install [[https://www.rust-lang.org/tools/install][Rust]]
  11. (Optional but I highly recommend it) adding bash to windows terminal.
    1. install windows terminal from the Microsoft store.
    2. open the terminal.
    3. open settings.
    4. click "Add a new profile"
    5. click "New empty profile"
    6. Click on "name" and rename it to "Git Bash"
    7. Click on "Command line" and click "Browse..."
    8. if you installed git using scoop then follow this(else the steps are mostly the same just a different path) navigate to ~C:\User\USERNAME\scoop\apps\git\2.37.1.windows.1\bin\bash.exe~ Where USERNAME is your username note that the name ~2.37.1.windows.1~ might be slightly different on your system
    9. click "Open"
    10. Click "Starting directory" and uncheck "Use parent process directory"
    11. Click "Save"
    12. now you can open gitbash from windows terminal
  12. Clone the repo for kami #+begin_src shell git clone https://github.com/mrfluffy-dev/kami.git && cd kami #+end_src
  13. Build kami using cargo #+begin_src shell cargo build --release #+end_src
  14. copy kami to path (for this to work, you need to use git bash and you need to run git bash in administrator mode0 #+begin_src cp target/release/kami.exe /usr/bin/kami #+end_src
  15. open kami by using ~kami~
  • Honorable mentions
  • [[https://github.com/pystardust/ani-cli][ani-cli]] Just a bunch of fucking nice people.
  • [[https://docs.rs/][rust docs]] Honestly its just so useful.
  • [[https://github.com/DemonKingSwarn/flix-cli][flix-cli]] For forcing me to make a release.