fav

Back up your favorite bilibili resources with CLI.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Compilation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Back up your favorite bilibili online resources with CLI.

(back to top)

Built With

• 

(back to top)

Getting Started

Prerequisites

• Install Rust

  curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  You may need add some dependencies for protobuf yourself.

Compilation

1. Clone the repo

   git clone https://github.com/kingwingfly/fav.git
2. Compilation

   cargo build --release

(back to top)

Usage

Need ffmpeg usable, and able to be directly called in cli.

$ fav -h
Fav's CLI, helping persist the remote source. Repo: https://github.com/kingwingfly/fav

Usage: fav <COMMAND>

Commands:
  init        Initialize the folder for fav
  auth        Login your account
  fetch       Fetch from remote
  status      Show status of local, default to show resource status
  track       Track a remote source
  untrack     Untrack a remote source
  pull        Pull remote resource to local
  daemon      Interval fetch and pull
  completion  Completions for the shell
  help        Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Steps

1. Init and Login first
2. Fetch the favorite list
3. Track the bvid or list_id you want to fav. You can see them through fav status -s/r
4. Fetch tracked resources
5. Pull the resources (Now only tracked resource can be pulled, since c_id is needed for pulling while only tracked resource has c_id fetched)

Example

# auto complete is supported; e.g:
$ fav completion fish > ~/.config/fish/completions/fav.fish
# init for bilibili
$ fav init
# scan code to login
$ fav auth login
# fetch favorite list
$ fav fetch
# show status
$ fav status -s
# track list (just like `git add`, by the way, commit is not needed)
$ fav track <list_id/bvid>
# fetch
$ fav fetch
# pull videos (support dry-run)
$ fav pull
# untrack list or video (just like `git rm`)
$ fav untrack <list_id/bvid>
# daemon
$ fav daemon 30

For more examples, please refer to the Documentation

(back to top)

Roadmap

• Init
• Auth
• Fetch
• Status
• Track
• Untrack
• Pull
• Push
• Ignore
• Like
• Sync
• Serve
• Tui
• Dynamic completion

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. Moreover, it is recommended to open an issue before coding to avoid repeated and useless work.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Louis - 836250617@qq.com

Project Link: https://github.com/kingwingfly/fav

(back to top)

Acknowledgments

• bilibili-API-collect

(back to top)