Small Invidious instances' maiden
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Arisu W. 2ae8e1b89b Add screenshots 9 months ago
mirious License notices 9 months ago
.flake8 Added logging. Added a CLI. 9 months ago
.gitignore Fetch JSON and parse to objects 9 months ago
LICENSE Init commit. 9 months ago Add screenshots 9 months ago
optional-requirements.txt Added function to get best instances. 9 months ago
requirements.txt Added function to get best instances. 9 months ago

Mirious - a small Invidious instances' maiden

Mirious is a small checker for Invidious instances. It fetches a list directly from the main server, so there is no need to manually keeping it up-to-date.

Mirious is licensed under GPL 3.0 or later.


  • Asyncronious
  • Can work as a library or a CLI utility
  • Sorts instaces as you wish to
  • Always has up-to-date list


Screenshot #1 Screenshot #2

Let's start!

To start a CLI:

python -m mirious

To use as a library:

import mirious.mirious as miri

# Do some great stuff!

Let's build!

  1. Create a virtual environment
python -m venv <name>
  1. Install dependecies
pip install -r reqiurements.txt
  1. (optional) Install more dependecies

These dependencies are not required, but help to develop Mirious.

pip install -r optional-requirements.txt

Known issues

  1. Sorting instances by ping takes too long

This is not a bug, really.. We have a request_timeout variable, so when some server is down it takes some time to give it a chance to response.

You have to re-define request_timeout with a lower delay to minimize an amount of seconds.

Default: aiohttp.ClientTimeout()


GPL notice

Mirious - a small Invidious instances' maiden. Copyright (C) 2021 Arisu W.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see