open-nami 1.0.0__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,16 @@
1
+ node_modules/
2
+ dist/
3
+ **/dist/
4
+ *.egg-info/
5
+ cookies/
6
+ *.cookies.txt
7
+ *cookie*.txt
8
+ downloads/
9
+ *.log
10
+ .DS_Store
11
+ .env
12
+ .env.*
13
+ .gemini/
14
+ .claude/
15
+ .agents/
16
+ .scratch/
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Open Selena
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,175 @@
1
+ Metadata-Version: 2.5
2
+ Name: open-nami
3
+ Version: 1.0.0
4
+ Summary: Fast terminal social media profile downloader and TUI for Instagram, TikTok, Facebook, and X.
5
+ Project-URL: Homepage, https://github.com/OpenSelena/open-nami
6
+ Project-URL: Repository, https://github.com/OpenSelena/open-nami.git
7
+ Project-URL: Issues, https://github.com/OpenSelena/open-nami/issues
8
+ Author-email: OpenSelena <igect@vk.com>
9
+ License-Expression: MIT
10
+ License-File: LICENSE
11
+ Keywords: cli,downloader,facebook,instagram,social-media,terminal,tiktok,tui,twitter
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Environment :: Console
14
+ Classifier: Intended Audience :: End Users/Desktop
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Operating System :: OS Independent
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: 3.13
23
+ Classifier: Topic :: Multimedia :: Graphics
24
+ Classifier: Topic :: Multimedia :: Video
25
+ Classifier: Topic :: Utilities
26
+ Requires-Python: >=3.9
27
+ Description-Content-Type: text/markdown
28
+
29
+ <p align="center">
30
+ <picture>
31
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/logo-dark.svg">
32
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/logo-light.svg" alt="Open Nami" width="240">
33
+ </picture>
34
+ </p>
35
+
36
+ <p align="center">
37
+ <b>Fast terminal social media profile downloader and TUI.</b><br/>
38
+ Bulk download photos, videos, stories, and highlights from Instagram, TikTok, Facebook, and X.
39
+ </p>
40
+
41
+ <p align="center">
42
+ <a href="https://www.npmjs.com/package/open-nami"><img src="https://img.shields.io/npm/v/open-nami.svg?color=C15F3C" alt="npm version"></a>
43
+ <a href="https://pypi.org/project/open-nami/"><img src="https://img.shields.io/pypi/v/open-nami.svg?color=3775A9" alt="PyPI version"></a>
44
+ <a href="https://github.com/OpenSelena/open-nami/actions/workflows/ci.yml"><img src="https://github.com/OpenSelena/open-nami/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
45
+ <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="Node version"></a>
46
+ <a href="https://github.com/OpenSelena/open-nami/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
47
+ </p>
48
+
49
+ ---
50
+
51
+ ## Key Features
52
+
53
+ - **Interactive Terminal UI**: Keyboard-driven navigation with auto, dark, and light themes (`Ctrl+T`).
54
+ - **Auto-Provisioned Engines**: Automatically downloads standalone `gallery-dl` and `yt-dlp` executables into `~/.open-nami/bin/` on first launch if not installed.
55
+ - **In-Place Scraper Updates**: Run `nami -U` anytime to fetch the latest scraper engine releases.
56
+ - **Four Command Aliases**: `open-nami`, `opennami`, `nami`, and `on`.
57
+ - **Targeted Category Extraction**: Download photos, videos, stories, highlights, or complete profile archives.
58
+ - **Automatic Directory Sorting**: Saves to your system Downloads folder under `<platform>/<username>/<category>/`. Override anytime with `-o, --output <dir>`.
59
+ - **Anti-Bot & Anti-Ban Hardening**:
60
+ - TikTok carousels: disables video extraction flags to prevent 403 errors on photo slides.
61
+ - TikTok videos: passes Chrome TLS impersonation (`--impersonate chrome`) through yt-dlp to clear Akamai WAF challenges.
62
+ - Instagram: throttles GraphQL pagination with jittered intervals (`2.0s–2.8s`) and downloads directly from Meta CDN edges.
63
+ - **Isolated Cookie Sessions**: Clones Netscape cookie files to an ephemeral temporary directory (`chmod 0600`) with automatic cleanup to prevent session corruption.
64
+ - **100% Local & Private**: Direct connections between your machine and platform servers. Zero telemetry, zero external tracking servers.
65
+
66
+ ---
67
+
68
+ ## Installation & Quick Start
69
+
70
+ ### Installation
71
+
72
+ ```sh
73
+ # npm (global)
74
+ npm install -g open-nami
75
+
76
+ # pip (Python)
77
+ pip install open-nami
78
+
79
+ # Homebrew (macOS & Linux)
80
+ brew install OpenSelena/tap/open-nami
81
+
82
+ # One-liner script (macOS & Linux)
83
+ curl -fsSL https://raw.githubusercontent.com/OpenSelena/open-nami/main/install.sh | sh
84
+
85
+ # Run without installing
86
+ npx open-nami [profile-or-url]
87
+ ```
88
+
89
+ ### Quick Start
90
+
91
+ Launch the interactive interface using any alias:
92
+ ```sh
93
+ nami
94
+ # or
95
+ on
96
+ # or
97
+ open-nami
98
+ ```
99
+
100
+ Jump straight to a profile:
101
+ ```sh
102
+ nami https://www.instagram.com/natgeo/
103
+ on @taylorswift
104
+ nami tt:zachking
105
+ ```
106
+
107
+ Direct headless downloads:
108
+ ```sh
109
+ # Photos only
110
+ nami @creator --photos
111
+
112
+ # Videos only
113
+ nami tt:creator --videos
114
+
115
+ # Instagram stories
116
+ nami ig:username --stories
117
+
118
+ # Full profile archive
119
+ nami @username --all
120
+
121
+ # Update engines
122
+ nami -U
123
+ ```
124
+
125
+ ### Hotkeys in TUI
126
+
127
+ | Key | Action |
128
+ | :--- | :--- |
129
+ | **`[Tab]`** | Paste URL from clipboard |
130
+ | **`[Enter]`** | Submit URL / Start download |
131
+ | **`[↑ / ↓]`** | Navigate format options |
132
+ | **`[^s]`** *(Ctrl+S)* | Settings (cookies & download directory) |
133
+ | **`[^t]`** *(Ctrl+T)* | Cycle theme (`auto` / `light` / `dark`) |
134
+ | **`[o]`** | Open destination folder in file manager |
135
+ | **`[Esc]`** | Back to URL input |
136
+ | **`[^c]`** *(Ctrl+C)* | Quit |
137
+
138
+ ### Interface Demo
139
+
140
+ #### 1. Paste Profile URL
141
+ <p align="center">
142
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/home.png" alt="URL Input Screen" width="100%">
143
+ </p>
144
+
145
+ #### 2. Select Media Category
146
+ <p align="center">
147
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/picker.png" alt="Media Target Picker" width="100%">
148
+ </p>
149
+
150
+ #### 3. Real-Time Download Progress
151
+ <p align="center">
152
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/downloading.png" alt="Real-time download progress" width="100%">
153
+ </p>
154
+
155
+ ---
156
+
157
+ ## Documentation
158
+
159
+ Full guides and technical specifications are available in the [`docs/`](https://github.com/OpenSelena/open-nami/tree/main/docs) directory:
160
+
161
+ - **[CLI Reference](https://github.com/OpenSelena/open-nami/blob/main/docs/cli-reference.md)**: Command flags, options, exit codes, and non-interactive scripting.
162
+ - **[Configuration Guide](https://github.com/OpenSelena/open-nami/blob/main/docs/configuration.md)**: `~/.open-nami/config.json` schema, settings menu, and environment variables.
163
+ - **[Cookie Authentication](https://github.com/OpenSelena/open-nami/blob/main/docs/cookies.md)**: Authenticated downloads for stories, highlights, private profiles, and ephemeral isolation.
164
+ - **[Anti-Bot Hardening](https://github.com/OpenSelena/open-nami/blob/main/docs/anti-bot.md)**: WAF mitigations, TLS fingerprint impersonation, request jitter, and 429 backoff.
165
+ - **[Shell Autocompletion](https://github.com/OpenSelena/open-nami/blob/main/docs/autocompletion.md)**: Autocomplete configuration for Bash, Zsh, Fish, and PowerShell.
166
+ - **[Fair Use Notice](https://github.com/OpenSelena/open-nami/blob/main/docs/fair-use.md)**: Section 107 copyright principles, personal archiving, and legal disclosures.
167
+
168
+ ---
169
+
170
+ ## License & Inquiries
171
+
172
+ Open Nami is released under the [MIT License](https://github.com/OpenSelena/open-nami/blob/main/LICENSE).
173
+
174
+ - **Organization**: [OpenSelena](https://github.com/OpenSelena)
175
+ - **Email**: [igect@vk.com](mailto:igect@vk.com)
@@ -0,0 +1,147 @@
1
+ <p align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/logo-dark.svg">
4
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/logo-light.svg" alt="Open Nami" width="240">
5
+ </picture>
6
+ </p>
7
+
8
+ <p align="center">
9
+ <b>Fast terminal social media profile downloader and TUI.</b><br/>
10
+ Bulk download photos, videos, stories, and highlights from Instagram, TikTok, Facebook, and X.
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://www.npmjs.com/package/open-nami"><img src="https://img.shields.io/npm/v/open-nami.svg?color=C15F3C" alt="npm version"></a>
15
+ <a href="https://pypi.org/project/open-nami/"><img src="https://img.shields.io/pypi/v/open-nami.svg?color=3775A9" alt="PyPI version"></a>
16
+ <a href="https://github.com/OpenSelena/open-nami/actions/workflows/ci.yml"><img src="https://github.com/OpenSelena/open-nami/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
17
+ <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="Node version"></a>
18
+ <a href="https://github.com/OpenSelena/open-nami/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
19
+ </p>
20
+
21
+ ---
22
+
23
+ ## Key Features
24
+
25
+ - **Interactive Terminal UI**: Keyboard-driven navigation with auto, dark, and light themes (`Ctrl+T`).
26
+ - **Auto-Provisioned Engines**: Automatically downloads standalone `gallery-dl` and `yt-dlp` executables into `~/.open-nami/bin/` on first launch if not installed.
27
+ - **In-Place Scraper Updates**: Run `nami -U` anytime to fetch the latest scraper engine releases.
28
+ - **Four Command Aliases**: `open-nami`, `opennami`, `nami`, and `on`.
29
+ - **Targeted Category Extraction**: Download photos, videos, stories, highlights, or complete profile archives.
30
+ - **Automatic Directory Sorting**: Saves to your system Downloads folder under `<platform>/<username>/<category>/`. Override anytime with `-o, --output <dir>`.
31
+ - **Anti-Bot & Anti-Ban Hardening**:
32
+ - TikTok carousels: disables video extraction flags to prevent 403 errors on photo slides.
33
+ - TikTok videos: passes Chrome TLS impersonation (`--impersonate chrome`) through yt-dlp to clear Akamai WAF challenges.
34
+ - Instagram: throttles GraphQL pagination with jittered intervals (`2.0s–2.8s`) and downloads directly from Meta CDN edges.
35
+ - **Isolated Cookie Sessions**: Clones Netscape cookie files to an ephemeral temporary directory (`chmod 0600`) with automatic cleanup to prevent session corruption.
36
+ - **100% Local & Private**: Direct connections between your machine and platform servers. Zero telemetry, zero external tracking servers.
37
+
38
+ ---
39
+
40
+ ## Installation & Quick Start
41
+
42
+ ### Installation
43
+
44
+ ```sh
45
+ # npm (global)
46
+ npm install -g open-nami
47
+
48
+ # pip (Python)
49
+ pip install open-nami
50
+
51
+ # Homebrew (macOS & Linux)
52
+ brew install OpenSelena/tap/open-nami
53
+
54
+ # One-liner script (macOS & Linux)
55
+ curl -fsSL https://raw.githubusercontent.com/OpenSelena/open-nami/main/install.sh | sh
56
+
57
+ # Run without installing
58
+ npx open-nami [profile-or-url]
59
+ ```
60
+
61
+ ### Quick Start
62
+
63
+ Launch the interactive interface using any alias:
64
+ ```sh
65
+ nami
66
+ # or
67
+ on
68
+ # or
69
+ open-nami
70
+ ```
71
+
72
+ Jump straight to a profile:
73
+ ```sh
74
+ nami https://www.instagram.com/natgeo/
75
+ on @taylorswift
76
+ nami tt:zachking
77
+ ```
78
+
79
+ Direct headless downloads:
80
+ ```sh
81
+ # Photos only
82
+ nami @creator --photos
83
+
84
+ # Videos only
85
+ nami tt:creator --videos
86
+
87
+ # Instagram stories
88
+ nami ig:username --stories
89
+
90
+ # Full profile archive
91
+ nami @username --all
92
+
93
+ # Update engines
94
+ nami -U
95
+ ```
96
+
97
+ ### Hotkeys in TUI
98
+
99
+ | Key | Action |
100
+ | :--- | :--- |
101
+ | **`[Tab]`** | Paste URL from clipboard |
102
+ | **`[Enter]`** | Submit URL / Start download |
103
+ | **`[↑ / ↓]`** | Navigate format options |
104
+ | **`[^s]`** *(Ctrl+S)* | Settings (cookies & download directory) |
105
+ | **`[^t]`** *(Ctrl+T)* | Cycle theme (`auto` / `light` / `dark`) |
106
+ | **`[o]`** | Open destination folder in file manager |
107
+ | **`[Esc]`** | Back to URL input |
108
+ | **`[^c]`** *(Ctrl+C)* | Quit |
109
+
110
+ ### Interface Demo
111
+
112
+ #### 1. Paste Profile URL
113
+ <p align="center">
114
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/home.png" alt="URL Input Screen" width="100%">
115
+ </p>
116
+
117
+ #### 2. Select Media Category
118
+ <p align="center">
119
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/picker.png" alt="Media Target Picker" width="100%">
120
+ </p>
121
+
122
+ #### 3. Real-Time Download Progress
123
+ <p align="center">
124
+ <img src="https://raw.githubusercontent.com/OpenSelena/open-nami/main/assets/downloading.png" alt="Real-time download progress" width="100%">
125
+ </p>
126
+
127
+ ---
128
+
129
+ ## Documentation
130
+
131
+ Full guides and technical specifications are available in the [`docs/`](https://github.com/OpenSelena/open-nami/tree/main/docs) directory:
132
+
133
+ - **[CLI Reference](https://github.com/OpenSelena/open-nami/blob/main/docs/cli-reference.md)**: Command flags, options, exit codes, and non-interactive scripting.
134
+ - **[Configuration Guide](https://github.com/OpenSelena/open-nami/blob/main/docs/configuration.md)**: `~/.open-nami/config.json` schema, settings menu, and environment variables.
135
+ - **[Cookie Authentication](https://github.com/OpenSelena/open-nami/blob/main/docs/cookies.md)**: Authenticated downloads for stories, highlights, private profiles, and ephemeral isolation.
136
+ - **[Anti-Bot Hardening](https://github.com/OpenSelena/open-nami/blob/main/docs/anti-bot.md)**: WAF mitigations, TLS fingerprint impersonation, request jitter, and 429 backoff.
137
+ - **[Shell Autocompletion](https://github.com/OpenSelena/open-nami/blob/main/docs/autocompletion.md)**: Autocomplete configuration for Bash, Zsh, Fish, and PowerShell.
138
+ - **[Fair Use Notice](https://github.com/OpenSelena/open-nami/blob/main/docs/fair-use.md)**: Section 107 copyright principles, personal archiving, and legal disclosures.
139
+
140
+ ---
141
+
142
+ ## License & Inquiries
143
+
144
+ Open Nami is released under the [MIT License](https://github.com/OpenSelena/open-nami/blob/main/LICENSE).
145
+
146
+ - **Organization**: [OpenSelena](https://github.com/OpenSelena)
147
+ - **Email**: [igect@vk.com](mailto:igect@vk.com)
@@ -0,0 +1,61 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "open-nami"
7
+ version = "1.0.0"
8
+ description = "Fast terminal social media profile downloader and TUI for Instagram, TikTok, Facebook, and X."
9
+ readme = "README.md"
10
+ requires-python = ">=3.9"
11
+ license = "MIT"
12
+ authors = [
13
+ { name = "OpenSelena", email = "igect@vk.com" }
14
+ ]
15
+ keywords = [
16
+ "downloader",
17
+ "instagram",
18
+ "tiktok",
19
+ "facebook",
20
+ "twitter",
21
+ "social-media",
22
+ "terminal",
23
+ "tui",
24
+ "cli"
25
+ ]
26
+ classifiers = [
27
+ "Development Status :: 5 - Production/Stable",
28
+ "Environment :: Console",
29
+ "Intended Audience :: End Users/Desktop",
30
+ "License :: OSI Approved :: MIT License",
31
+ "Operating System :: OS Independent",
32
+ "Programming Language :: Python :: 3",
33
+ "Programming Language :: Python :: 3.9",
34
+ "Programming Language :: Python :: 3.10",
35
+ "Programming Language :: Python :: 3.11",
36
+ "Programming Language :: Python :: 3.12",
37
+ "Programming Language :: Python :: 3.13",
38
+ "Topic :: Multimedia :: Video",
39
+ "Topic :: Multimedia :: Graphics",
40
+ "Topic :: Utilities",
41
+ ]
42
+ dependencies = []
43
+
44
+ [project.urls]
45
+ Homepage = "https://github.com/OpenSelena/open-nami"
46
+ Repository = "https://github.com/OpenSelena/open-nami.git"
47
+ Issues = "https://github.com/OpenSelena/open-nami/issues"
48
+
49
+ [project.scripts]
50
+ open-nami = "open_nami.cli:main"
51
+ opennami = "open_nami.cli:main"
52
+ nami = "open_nami.cli:main"
53
+ on = "open_nami.cli:main"
54
+
55
+ [tool.hatch.build.targets.wheel]
56
+ packages = ["src/open_nami"]
57
+ ignore-vcs = true
58
+
59
+ [tool.hatch.build.targets.sdist]
60
+ only-include = ["src/open_nami", "README.md", "LICENSE"]
61
+ ignore-vcs = true
@@ -0,0 +1,8 @@
1
+ """
2
+ Open Nami - Fast terminal social media profile downloader and TUI.
3
+ Bulk download photos, videos, stories, and highlights from Instagram, TikTok, Facebook, and X.
4
+ """
5
+
6
+ __version__ = "1.0.0"
7
+ __author__ = "OpenSelena"
8
+ __license__ = "MIT"
@@ -0,0 +1,45 @@
1
+ #!/usr/bin/env node
2
+ import { createRequire as __createRequire } from 'node:module';
3
+ const require = __createRequire(import.meta.url);
4
+ var __create = Object.create;
5
+ var __defProp = Object.defineProperty;
6
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
7
+ var __getOwnPropNames = Object.getOwnPropertyNames;
8
+ var __getProtoOf = Object.getPrototypeOf;
9
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
10
+ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
11
+ get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
12
+ }) : x)(function(x) {
13
+ if (typeof require !== "undefined") return require.apply(this, arguments);
14
+ throw Error('Dynamic require of "' + x + '" is not supported');
15
+ });
16
+ var __commonJS = (cb, mod) => function __require2() {
17
+ return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
18
+ };
19
+ var __export = (target, all) => {
20
+ for (var name in all)
21
+ __defProp(target, name, { get: all[name], enumerable: true });
22
+ };
23
+ var __copyProps = (to, from, except, desc) => {
24
+ if (from && typeof from === "object" || typeof from === "function") {
25
+ for (let key of __getOwnPropNames(from))
26
+ if (!__hasOwnProp.call(to, key) && key !== except)
27
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
28
+ }
29
+ return to;
30
+ };
31
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
32
+ // If the importer is in node compatibility mode or this is not an ESM
33
+ // file that has been converted to a CommonJS file using a Babel-
34
+ // compatible transform (i.e. "__esModule" has not been set), then set
35
+ // "default" to the CommonJS "module.exports" for node compatibility.
36
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
37
+ mod
38
+ ));
39
+
40
+ export {
41
+ __require,
42
+ __commonJS,
43
+ __export,
44
+ __toESM
45
+ };