⚡ Installation
With cargo
cargo install nyaa
On Arch Linux (AUR)
yay -S nyaa
Windows/Linux Binaries
Binaries for Linux and Windows are available on the releases page.
From Source
To build from source, you must have both git
and cargo
installed.
git clone https://github.com/Beastwick18/nyaa
cd nyaa
cargo install --path .
Ubuntu/Debian
Download the .deb file from the latest release and install with apt
:
or dpkg
⌨️ Keybinds
- Like modal text editors such as Vim, there are several modes. Each have their own keybinds, which can be found out by pressing
F1
or?
while in that mode. For a list of all modes and their respective keybinds, check KEYS.md.
Proxies
If nyaa.si
is not accessible in your region, try one of the proxies. Once you find one that works, replace the value for base_url
in the default config with the working proxy url. I would recommend nyaa.land
, as it is very compatible, and usually working. Here's what the config for nyaa.land
would look like:
= 'nyaa.land'
⚙️ Configuration
The default configuration file looks like:
= 'bash -c "curl {torrent} > ~/torrents/{title}.torrent"'
= 'Default'
= 'AllCategories'
= 'NoFilter'
= 'Date'
= ''
= 'NyaaHtml'
= 'https://nyaa.si'
= 30
torrent_client_cmd
is the command that will be run once Enter
is pressed on a selected torrent. Typically, this is meant to open a torrent client along with the magnet/torrent link passed along as an argument. There are multiple placeholders you can use to fill in information for the command.
{torrent}
- The link to the torrent file hosted on nyaa.si{magnet}
- The magnet link associated with the torrent{title}
- The title of the post on nyaa.si{file}
- The name of the torrent file hosted on nyaa.si
default_theme
refers to the theme selected by default when the app is opened. Possible values are Default
, Dracula
, Gruvbox
, or Catppuccin Macchiato
. Custom themes coming soon!
default_category
refers to the category selected by default when the app is opened. Possible values are defined in CATEGORIES.md.
default_filter
refers to the filter selected by default when the app is opened. Possible values are NoFilter
, NoRemakes
, TrustedOnly
or Batches
.
default_sort
refers to the sort selected by default when the app is opened. Possible values are Date
, Downloads
, Seeders
, Leechers
, or Size
.
default_search
refers to the search entered once the app is opened.
default_source
refers to the source selected by default once the app is opened. Possible values are NyaaHtml
and NyaaRss
.
base_url
refers to the url used to make requests. Change this to any nyaa mirror url in the format: http(s)://nyaa.si
or nyaa.si
timeout
refers to how long the program will wait for a search request before it times out. This value is measured in seconds. You may want to increase this if your request times are usually long.
🗺️ Planned Features
- RPM Release
- User-defined themes
- Sources other than nyaa/Custom user-defined sources
-
Nyaa proxies/mirrors support -
Page navigation -
Choice between HTML scraper or RSS feed