animesama 1.0.7__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,183 @@
1
+ Metadata-Version: 2.4
2
+ Name: animesama
3
+ Version: 1.0.7
4
+ Summary: Browse and watch anime from anime-sama.fr directly in your terminal
5
+ Author-email: Miro-sh <65116975+Miro-sh@users.noreply.github.com>
6
+ License: GPL-3.0-only
7
+ Project-URL: Homepage, https://github.com/Miro-sh/animesama-cli
8
+ Project-URL: Repository, https://github.com/Miro-sh/animesama-cli
9
+ Project-URL: Issues, https://github.com/Miro-sh/animesama-cli/issues
10
+ Keywords: anime,cli,tui,mpv,terminal
11
+ Classifier: Environment :: Console
12
+ Classifier: Intended Audience :: End Users/Desktop
13
+ Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
14
+ Classifier: Operating System :: POSIX :: Linux
15
+ Classifier: Operating System :: Microsoft :: Windows
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Topic :: Multimedia :: Video
18
+ Requires-Python: >=3.9
19
+ Description-Content-Type: text/markdown
20
+ Requires-Dist: requests
21
+ Requires-Dist: beautifulsoup4
22
+ Requires-Dist: textual>=0.44.0
23
+ Requires-Dist: windows-curses; sys_platform == "win32"
24
+
25
+ <div align="center">
26
+
27
+ # animesama-cli
28
+
29
+ Browse and watch anime from [anime-sama.fr](https://anime-sama.fr) directly in your terminal.
30
+
31
+ <a href="https://aur.archlinux.org/packages/animesama-cli"><img src="https://img.shields.io/aur/version/animesama-cli" alt="AUR version"></a>
32
+ <a href="https://pypi.org/project/animesama"><img src="https://img.shields.io/pypi/v/animesama" alt="PyPI version"></a>
33
+ <img src="https://img.shields.io/badge/platform-linux-90ee90" alt="Linux">
34
+ <img src="https://img.shields.io/badge/platform-windows-90ee90" alt="Windows">
35
+
36
+ </div>
37
+
38
+ ## Demo
39
+
40
+ <div align="center">
41
+
42
+ ![animesama-cli demo](./assets/demo.gif)
43
+
44
+ </div>
45
+
46
+ ## Overview
47
+
48
+ animesama-cli is a terminal application for browsing and watching anime from [anime-sama.fr](https://anime-sama.fr). It provides catalog search, persistent watch history, and the weekly release schedule. Video playback is handled by [mpv](https://mpv.io).
49
+
50
+ ## Features
51
+
52
+ - Full-text search of the anime-sama.fr catalog
53
+ - Interactive TUI built with [Textual](https://textual.textualize.io/), with a standard CLI fallback
54
+ - Watch history stored in SQLite, with resume support
55
+ - Weekly release schedule from anime-sama.fr
56
+ - Upcoming episodes from animecountdown.com
57
+ - French dub (VF) and Japanese audio with French subtitles (VOSTFR)
58
+ - Linux and Windows support; AUR package available for Arch Linux
59
+
60
+ ## Installation
61
+
62
+ ### Linux
63
+
64
+ Debian / Ubuntu: the script installs `mpv`, `pipx` and the application.
65
+
66
+ ```sh
67
+ sudo apt-get install curl -y
68
+ curl -fsSL https://raw.githubusercontent.com/Miro-sh/animesama-cli/master/install_unix.sh -o /tmp/animesama-install.sh && chmod +x /tmp/animesama-install.sh && sh /tmp/animesama-install.sh
69
+ ```
70
+
71
+ Arch Linux (AUR):
72
+
73
+ ```sh
74
+ yay -S animesama-cli
75
+ ```
76
+
77
+ Any distribution with [pipx](https://pipx.pypa.io) (requires `mpv`):
78
+
79
+ ```sh
80
+ pipx install animesama
81
+ ```
82
+
83
+ ### Windows
84
+
85
+ Run the following command in PowerShell (no administrator rights required):
86
+
87
+ ```powershell
88
+ irm "https://raw.githubusercontent.com/Miro-sh/animesama-cli/refs/heads/master/install_windows.bat" -OutFile install.bat; .\install.bat
89
+ ```
90
+
91
+ The script installs the application via [pipx](https://pipx.pypa.io) and downloads mpv. Restart your terminal after installation, then run `animesama-cli`.
92
+
93
+ ## Usage
94
+
95
+ | Command | Description |
96
+ |---------|-------------|
97
+ | `animesama-cli` | Launch the TUI (falls back to CLI if Textual is not installed) |
98
+ | `animesama-cli --cli` | Force CLI mode |
99
+ | `animesama-cli naruto` | Search directly |
100
+ | `animesama-cli --vf naruto` | Search French dub only |
101
+ | `animesama-cli -c` | Show watch history |
102
+ | `animesama-cli -cf` | History with last-episode check |
103
+ | `animesama-cli -p` | Weekly schedule |
104
+ | `animesama-cli -up` | Upcoming episodes |
105
+ | `animesama-cli --debug naruto` | Search with debug output |
106
+ | `animesama-cli -h` | Show all options |
107
+
108
+ The watch history is stored at `~/.local/share/animesama-cli/history.db` and can be opened with any SQLite browser.
109
+
110
+ ## Uninstall
111
+
112
+ <details>
113
+
114
+ **AUR:**
115
+
116
+ ```sh
117
+ yay -R animesama-cli
118
+ ```
119
+
120
+ **pipx (Linux and Windows):**
121
+
122
+ ```sh
123
+ pipx uninstall animesama
124
+ ```
125
+
126
+ **Windows (mpv installed by the script):**
127
+
128
+ ```batch
129
+ rd /s /q "%USERPROFILE%\AnimeSamaCLI"
130
+ ```
131
+
132
+ **Old manual installs (before 1.0.7):**
133
+
134
+ ```sh
135
+ sudo rm /usr/local/bin/animesama-cli
136
+ rm -rf ~/animesama-cli
137
+ rm -rf ~/.local/share/animesama-venv
138
+ ```
139
+
140
+ </details>
141
+
142
+ ## Dependencies
143
+
144
+ | Category | Packages |
145
+ |----------|----------|
146
+ | Python | `requests`, `beautifulsoup4`, `textual` (optional, for the TUI), `windows-curses` (Windows only) |
147
+ | System | `mpv`, `git`, `python3` |
148
+
149
+ Built-in Python modules used: `sqlite3`, `re`, `json`, `sys`, `os`, `time`, `datetime`, `locale`, `pathlib`, `subprocess`, `asyncio`.
150
+
151
+ ## FAQ
152
+
153
+ <details>
154
+ <summary>Click to expand</summary>
155
+ <br>
156
+
157
+ **Can I change or disable subtitles?** No. Subtitles are embedded in the video stream.
158
+
159
+ **Can I watch in French?** Yes. Use `--vf` when searching.
160
+
161
+ **Can I switch the audio language?** No. The site only provides French dub and Japanese audio with French subtitles.
162
+
163
+ **Can I use a different video source?** No, unless you write your own scraper.
164
+
165
+ **Can I use VLC?** No. Only `mpv` is supported.
166
+
167
+ **Where can I find all the options?** Run `animesama-cli --help`.
168
+
169
+ </details>
170
+
171
+ ## Related projects
172
+
173
+ - [ani-cli](https://github.com/pystardust/ani-cli): Japanese audio, English subtitles (4anime, gogoanime, allmanga). animesama-cli was inspired by this project.
174
+ - [GoAnime](https://github.com/alvarorichard/GoAnime): Japanese audio, Portuguese subtitles
175
+ - [doccli](https://github.com/TowarzyszFatCat/doccli): Japanese audio, Polish subtitles (docchi.pl)
176
+
177
+ ## Contributing
178
+
179
+ Contributions are welcome. Please read [CONTRIBUTING.md](./contribution.md) before opening an issue or pull request. You can also join the [Discord server](https://discord.gg/MwHAXPpJ8C) to discuss the project.
180
+
181
+ ## Disclaimer
182
+
183
+ This project only fetches publicly available content and hosts nothing itself. Users are responsible for how they use it. See [DISCLAIMER.md](./disclaimer.md) for details.
@@ -0,0 +1,159 @@
1
+ <div align="center">
2
+
3
+ # animesama-cli
4
+
5
+ Browse and watch anime from [anime-sama.fr](https://anime-sama.fr) directly in your terminal.
6
+
7
+ <a href="https://aur.archlinux.org/packages/animesama-cli"><img src="https://img.shields.io/aur/version/animesama-cli" alt="AUR version"></a>
8
+ <a href="https://pypi.org/project/animesama"><img src="https://img.shields.io/pypi/v/animesama" alt="PyPI version"></a>
9
+ <img src="https://img.shields.io/badge/platform-linux-90ee90" alt="Linux">
10
+ <img src="https://img.shields.io/badge/platform-windows-90ee90" alt="Windows">
11
+
12
+ </div>
13
+
14
+ ## Demo
15
+
16
+ <div align="center">
17
+
18
+ ![animesama-cli demo](./assets/demo.gif)
19
+
20
+ </div>
21
+
22
+ ## Overview
23
+
24
+ animesama-cli is a terminal application for browsing and watching anime from [anime-sama.fr](https://anime-sama.fr). It provides catalog search, persistent watch history, and the weekly release schedule. Video playback is handled by [mpv](https://mpv.io).
25
+
26
+ ## Features
27
+
28
+ - Full-text search of the anime-sama.fr catalog
29
+ - Interactive TUI built with [Textual](https://textual.textualize.io/), with a standard CLI fallback
30
+ - Watch history stored in SQLite, with resume support
31
+ - Weekly release schedule from anime-sama.fr
32
+ - Upcoming episodes from animecountdown.com
33
+ - French dub (VF) and Japanese audio with French subtitles (VOSTFR)
34
+ - Linux and Windows support; AUR package available for Arch Linux
35
+
36
+ ## Installation
37
+
38
+ ### Linux
39
+
40
+ Debian / Ubuntu: the script installs `mpv`, `pipx` and the application.
41
+
42
+ ```sh
43
+ sudo apt-get install curl -y
44
+ curl -fsSL https://raw.githubusercontent.com/Miro-sh/animesama-cli/master/install_unix.sh -o /tmp/animesama-install.sh && chmod +x /tmp/animesama-install.sh && sh /tmp/animesama-install.sh
45
+ ```
46
+
47
+ Arch Linux (AUR):
48
+
49
+ ```sh
50
+ yay -S animesama-cli
51
+ ```
52
+
53
+ Any distribution with [pipx](https://pipx.pypa.io) (requires `mpv`):
54
+
55
+ ```sh
56
+ pipx install animesama
57
+ ```
58
+
59
+ ### Windows
60
+
61
+ Run the following command in PowerShell (no administrator rights required):
62
+
63
+ ```powershell
64
+ irm "https://raw.githubusercontent.com/Miro-sh/animesama-cli/refs/heads/master/install_windows.bat" -OutFile install.bat; .\install.bat
65
+ ```
66
+
67
+ The script installs the application via [pipx](https://pipx.pypa.io) and downloads mpv. Restart your terminal after installation, then run `animesama-cli`.
68
+
69
+ ## Usage
70
+
71
+ | Command | Description |
72
+ |---------|-------------|
73
+ | `animesama-cli` | Launch the TUI (falls back to CLI if Textual is not installed) |
74
+ | `animesama-cli --cli` | Force CLI mode |
75
+ | `animesama-cli naruto` | Search directly |
76
+ | `animesama-cli --vf naruto` | Search French dub only |
77
+ | `animesama-cli -c` | Show watch history |
78
+ | `animesama-cli -cf` | History with last-episode check |
79
+ | `animesama-cli -p` | Weekly schedule |
80
+ | `animesama-cli -up` | Upcoming episodes |
81
+ | `animesama-cli --debug naruto` | Search with debug output |
82
+ | `animesama-cli -h` | Show all options |
83
+
84
+ The watch history is stored at `~/.local/share/animesama-cli/history.db` and can be opened with any SQLite browser.
85
+
86
+ ## Uninstall
87
+
88
+ <details>
89
+
90
+ **AUR:**
91
+
92
+ ```sh
93
+ yay -R animesama-cli
94
+ ```
95
+
96
+ **pipx (Linux and Windows):**
97
+
98
+ ```sh
99
+ pipx uninstall animesama
100
+ ```
101
+
102
+ **Windows (mpv installed by the script):**
103
+
104
+ ```batch
105
+ rd /s /q "%USERPROFILE%\AnimeSamaCLI"
106
+ ```
107
+
108
+ **Old manual installs (before 1.0.7):**
109
+
110
+ ```sh
111
+ sudo rm /usr/local/bin/animesama-cli
112
+ rm -rf ~/animesama-cli
113
+ rm -rf ~/.local/share/animesama-venv
114
+ ```
115
+
116
+ </details>
117
+
118
+ ## Dependencies
119
+
120
+ | Category | Packages |
121
+ |----------|----------|
122
+ | Python | `requests`, `beautifulsoup4`, `textual` (optional, for the TUI), `windows-curses` (Windows only) |
123
+ | System | `mpv`, `git`, `python3` |
124
+
125
+ Built-in Python modules used: `sqlite3`, `re`, `json`, `sys`, `os`, `time`, `datetime`, `locale`, `pathlib`, `subprocess`, `asyncio`.
126
+
127
+ ## FAQ
128
+
129
+ <details>
130
+ <summary>Click to expand</summary>
131
+ <br>
132
+
133
+ **Can I change or disable subtitles?** No. Subtitles are embedded in the video stream.
134
+
135
+ **Can I watch in French?** Yes. Use `--vf` when searching.
136
+
137
+ **Can I switch the audio language?** No. The site only provides French dub and Japanese audio with French subtitles.
138
+
139
+ **Can I use a different video source?** No, unless you write your own scraper.
140
+
141
+ **Can I use VLC?** No. Only `mpv` is supported.
142
+
143
+ **Where can I find all the options?** Run `animesama-cli --help`.
144
+
145
+ </details>
146
+
147
+ ## Related projects
148
+
149
+ - [ani-cli](https://github.com/pystardust/ani-cli): Japanese audio, English subtitles (4anime, gogoanime, allmanga). animesama-cli was inspired by this project.
150
+ - [GoAnime](https://github.com/alvarorichard/GoAnime): Japanese audio, Portuguese subtitles
151
+ - [doccli](https://github.com/TowarzyszFatCat/doccli): Japanese audio, Polish subtitles (docchi.pl)
152
+
153
+ ## Contributing
154
+
155
+ Contributions are welcome. Please read [CONTRIBUTING.md](./contribution.md) before opening an issue or pull request. You can also join the [Discord server](https://discord.gg/MwHAXPpJ8C) to discuss the project.
156
+
157
+ ## Disclaimer
158
+
159
+ This project only fetches publicly available content and hosts nothing itself. Users are responsible for how they use it. See [DISCLAIMER.md](./disclaimer.md) for details.