goyabu-cli


Namegoyabu-cli JSON
Version 1.0.14 PyPI version JSON
download
home_pagehttps://github.com/AlanJs26/goyabu-cli
Summaryquickly play anime from terminal
upload_time2023-03-16 18:45:03
maintainer
docs_urlNone
authorAlanJS26
requires_python>=3.6
licenseMIT License Copyright (c) 2018 Alan José Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords python cli anime
VCS
bugtrack_url
requirements parsel PyBypass python_mpv_jsonipc requests rich setuptools termtables
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # goyabu-cli

<!--## assista animes diretamente do terminal-->
## 😎 Watch animes without leaving the terminal!

![Novo anime](https://github.com/AlanJs26/goyabu-cli/blob/main/img/record1.gif?raw=true)
![Retomando uma sessão anterior](https://github.com/AlanJs26/goyabu-cli/blob/main/img/record2.gif?raw=true)

<!--digite `anime` e siga as instruções para utilizar.-->
## 🚀 How to use



Type `anime` in the terminal to start the program

then you will be asked to type which anime/series you want to watch. After that, select one of the found anime/series, select the episodes you want to watch using the `spacebar` (or pressing enter to watch them all) and, finally, enjoy 😊.



<!--## ⚙ Instalação-->
## 📦 Installation

Requirements:
- Python 3
- MPV player (recommended)

Installation can be done using pip:

```bash
pip install goyabu-cli
```

<!--Com isso digitando `anime` no terminal, o programa deve funcionar-->

To run the program type `anime` in the terminal.

```bash
# run the bellow command to update the program
pip install --upgrade goyabu-cli
```


<!--## Instalação manual-->
## ⚙ Manual installation

Install Python 3, MPV and git 

Clone this repository 
```bash
git clone 'https://github.com/AlanJs26/goyabu-cli' && cd goyabu-cli
```

Install all pythons dependencies 
```bash
pip install -r requirements.txt
```

<!--Assim o programa pode ser executado com `python anime.py` -->
To run the program, type `python runner.py` in the program folder or add to your system path

## Available sources 

| Source                                                | Description                                                        | Language   | Comments           |
| ----------------------------------------------------- | ------------------------------------------------------------------ | ---------- | ------------------ |
| [animefire](https://animefire.com/)             | website used to watch anime                                        | Portuguese |                    |
| [goyabu](https://goyabu.com/)             | website used to watch anime                                        | Portuguese |                    |
| [superanimes](https://superanimes.biz/)             | website used to watch anime                                        | Portuguese |                    |
| [gogoanime](https://gogoanime.dk/)             | website used to watch anime                                        | English |                    |
| [vizer](https://vizer.tv/)             | website used to watch movies,tv shows and animes                                        | Portuguese,English |                    |

## Language

I'm Brazilian, so my primary focus is on portuguese sources for anime/series, but I have also translated the program to english and added some english sources.

## Compatibility

This app was tested on linux, but probably works in windows too. Some issues that windows users can have are:

- Lists not displaying properly
- MPV integration could not work
- file path issues

If you find some bug, please open and issue here on github.

## Tips

### Previous sessions

In the start screen you can press the `arrow up` or `Tab` to select something you have watched before. Or even type one of the numbers on the left instead of typing the whole name.

> All lists are scrollable, you check by looking for a little arrow at the top or bottom of the list.

As 1 will always be the last anime/series watched, you can use this in the command line to jump directly on your previous session.

```bash
anime 1 --yes
```

> Here I also used `--yes` to accept all prompts

### Command arguments

All available arguments are listed below:

> -  `--episodes` select which episodes to watch. The syntax is `start:end` or `episode`.
> -  `--player` specify the player do you want to use (default: mpv)
> -  `--scraper` use specified scraper to fetch the episodes
> -  `--update` fetch the number of total episodes of the items in history.
> -  `--server` serves a list of animes as a m3u playlist through the network.
> -  `--config` change the default config.
> -  `--anilist_sync` sync your local history with anilist
> -  `--yes` accept all default options. it is useful then you already know the full name of the anime/series
> -  `--config-dir` specify the folder to save the playlist file

for more information run `anime --help`

### Anilist

to enable anilist sync,to enable synchronization with anilist, you must first run the command `anime --config` and select the field 'token'. This will open a browser window asking for confirmation. 


### MPV

I strongly recommend the use of MPV player on top of this cli program, since with MPV is possible to start the stream at the exact point you left on the previous session.

I recommend my [MPV config](https://github.com/AlanJs26/mpv), it comes with a pretty ui, shaders and some plugins. One of them being `skiptosilence`, that is used to jump anime openings! (I have mapped `Tab` to activate it)



## To-do

- [x] upload project to pypi
- [ ] add more sources



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/AlanJs26/goyabu-cli",
    "name": "goyabu-cli",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "python,cli,anime",
    "author": "AlanJS26",
    "author_email": "AlanJS26 <alanjoses.29@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/d2/af/aa1f5c67c9dd131facd366f89039c3e1a97a1d52277121fbb0213b6e3589/goyabu-cli-1.0.14.tar.gz",
    "platform": null,
    "description": "# goyabu-cli\n\n<!--## assista animes diretamente do terminal-->\n## \ud83d\ude0e Watch animes without leaving the terminal!\n\n![Novo anime](https://github.com/AlanJs26/goyabu-cli/blob/main/img/record1.gif?raw=true)\n![Retomando uma sess\u00e3o anterior](https://github.com/AlanJs26/goyabu-cli/blob/main/img/record2.gif?raw=true)\n\n<!--digite `anime` e siga as instru\u00e7\u00f5es para utilizar.-->\n## \ud83d\ude80 How to use\n\n\n\nType `anime` in the terminal to start the program\n\nthen you will be asked to type which anime/series you want to watch. After that, select one of the found anime/series, select the episodes you want to watch using the `spacebar` (or pressing enter to watch them all) and, finally, enjoy \ud83d\ude0a.\n\n\n\n<!--## \u2699 Instala\u00e7\u00e3o-->\n## \ud83d\udce6 Installation\n\nRequirements:\n- Python 3\n- MPV player (recommended)\n\nInstallation can be done using pip:\n\n```bash\npip install goyabu-cli\n```\n\n<!--Com isso digitando `anime` no terminal, o programa deve funcionar-->\n\nTo run the program type `anime` in the terminal.\n\n```bash\n# run the bellow command to update the program\npip install --upgrade goyabu-cli\n```\n\n\n<!--## Instala\u00e7\u00e3o manual-->\n## \u2699 Manual installation\n\nInstall Python 3, MPV and git \n\nClone this repository \n```bash\ngit clone 'https://github.com/AlanJs26/goyabu-cli' && cd goyabu-cli\n```\n\nInstall all pythons dependencies \n```bash\npip install -r requirements.txt\n```\n\n<!--Assim o programa pode ser executado com `python anime.py` -->\nTo run the program, type `python runner.py` in the program folder or add to your system path\n\n## Available sources \n\n| Source                                                | Description                                                        | Language   | Comments           |\n| ----------------------------------------------------- | ------------------------------------------------------------------ | ---------- | ------------------ |\n| [animefire](https://animefire.com/)             | website used to watch anime                                        | Portuguese |                    |\n| [goyabu](https://goyabu.com/)             | website used to watch anime                                        | Portuguese |                    |\n| [superanimes](https://superanimes.biz/)             | website used to watch anime                                        | Portuguese |                    |\n| [gogoanime](https://gogoanime.dk/)             | website used to watch anime                                        | English |                    |\n| [vizer](https://vizer.tv/)             | website used to watch movies,tv shows and animes                                        | Portuguese,English |                    |\n\n## Language\n\nI'm Brazilian, so my primary focus is on portuguese sources for anime/series, but I have also translated the program to english and added some english sources.\n\n## Compatibility\n\nThis app was tested on linux, but probably works in windows too. Some issues that windows users can have are:\n\n- Lists not displaying properly\n- MPV integration could not work\n- file path issues\n\nIf you find some bug, please open and issue here on github.\n\n## Tips\n\n### Previous sessions\n\nIn the start screen you can press the `arrow up` or `Tab` to select something you have watched before. Or even type one of the numbers on the left instead of typing the whole name.\n\n> All lists are scrollable, you check by looking for a little arrow at the top or bottom of the list.\n\nAs 1 will always be the last anime/series watched, you can use this in the command line to jump directly on your previous session.\n\n```bash\nanime 1 --yes\n```\n\n> Here I also used `--yes` to accept all prompts\n\n### Command arguments\n\nAll available arguments are listed below:\n\n> -  `--episodes` select which episodes to watch. The syntax is `start:end` or `episode`.\n> -  `--player` specify the player do you want to use (default: mpv)\n> -  `--scraper` use specified scraper to fetch the episodes\n> -  `--update` fetch the number of total episodes of the items in history.\n> -  `--server` serves a list of animes as a m3u playlist through the network.\n> -  `--config` change the default config.\n> -  `--anilist_sync` sync your local history with anilist\n> -  `--yes` accept all default options. it is useful then you already know the full name of the anime/series\n> -  `--config-dir` specify the folder to save the playlist file\n\nfor more information run `anime --help`\n\n### Anilist\n\nto enable anilist sync,to enable synchronization with anilist, you must first run the command `anime --config` and select the field 'token'. This will open a browser window asking for confirmation. \n\n\n### MPV\n\nI strongly recommend the use of MPV player on top of this cli program, since with MPV is possible to start the stream at the exact point you left on the previous session.\n\nI recommend my [MPV config](https://github.com/AlanJs26/mpv), it comes with a pretty ui, shaders and some plugins. One of them being `skiptosilence`, that is used to jump anime openings! (I have mapped `Tab` to activate it)\n\n\n\n## To-do\n\n- [x] upload project to pypi\n- [ ] add more sources\n\n\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2018 Alan Jos\u00e9  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "quickly play anime from terminal",
    "version": "1.0.14",
    "split_keywords": [
        "python",
        "cli",
        "anime"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "00078b11f4bf1338bda63e40971cc9057c3f3e5c4d87d95ce55e14f557f61638",
                "md5": "b064cd5d594d8a3a6d67345c9a049b78",
                "sha256": "e29d8fb7eeb045522b5f927d36df337ef28a5b5005fada3602ad4fdd16aa691a"
            },
            "downloads": -1,
            "filename": "goyabu_cli-1.0.14-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b064cd5d594d8a3a6d67345c9a049b78",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 37797,
            "upload_time": "2023-03-16T18:45:00",
            "upload_time_iso_8601": "2023-03-16T18:45:00.699531Z",
            "url": "https://files.pythonhosted.org/packages/00/07/8b11f4bf1338bda63e40971cc9057c3f3e5c4d87d95ce55e14f557f61638/goyabu_cli-1.0.14-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d2afaa1f5c67c9dd131facd366f89039c3e1a97a1d52277121fbb0213b6e3589",
                "md5": "ad85aa247b4cee65af67e4903ec4dab1",
                "sha256": "d963408265de82a343481d06bdd939bbdd5a277db00f77695af0e52812289a14"
            },
            "downloads": -1,
            "filename": "goyabu-cli-1.0.14.tar.gz",
            "has_sig": false,
            "md5_digest": "ad85aa247b4cee65af67e4903ec4dab1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 30483,
            "upload_time": "2023-03-16T18:45:03",
            "upload_time_iso_8601": "2023-03-16T18:45:03.266990Z",
            "url": "https://files.pythonhosted.org/packages/d2/af/aa1f5c67c9dd131facd366f89039c3e1a97a1d52277121fbb0213b6e3589/goyabu-cli-1.0.14.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-03-16 18:45:03",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "AlanJs26",
    "github_project": "goyabu-cli",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "parsel",
            "specs": [
                [
                    "==",
                    "1.7.0"
                ]
            ]
        },
        {
            "name": "PyBypass",
            "specs": [
                [
                    "==",
                    "2.0.1"
                ]
            ]
        },
        {
            "name": "python_mpv_jsonipc",
            "specs": [
                [
                    "==",
                    "1.1.13"
                ]
            ]
        },
        {
            "name": "requests",
            "specs": [
                [
                    "==",
                    "2.28.2"
                ]
            ]
        },
        {
            "name": "rich",
            "specs": [
                [
                    "==",
                    "13.3.2"
                ]
            ]
        },
        {
            "name": "setuptools",
            "specs": [
                [
                    "==",
                    "64.0.1"
                ]
            ]
        },
        {
            "name": "termtables",
            "specs": [
                [
                    "==",
                    "0.2.4"
                ]
            ]
        }
    ],
    "lcname": "goyabu-cli"
}
        
Elapsed time: 0.05551s