Naminter


NameNaminter JSON
Version 1.0.0 PyPI version JSON
download
home_pagehttps://github.com/3xp0rt/Naminter
SummaryA description of your package and CLI tool
upload_time2025-02-10 02:47:40
maintainerNone
docs_urlNone
author3xp0rt
requires_python>=3.7
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 🔍 Naminter

[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

The most powerful and fast username availability checker that searches across hundreds of websites using [WhatsMyName](https://github.com/WebBreacher/WhatsMyName) dataset. Naminter features full support of WhatsMyName data scheme, a beautiful console interface, browser impersonating, concurrent checking, and extensive configuration options.

![Naminter Demo](demo.gif)

## ✨ Features

- Full support of [WhatsMyName](https://github.com/WebBreacher/WhatsMyName) data scheme and updates
- Check username availability across 600+ websites from WhatsMyName database
- Accurate browser impersonation for enhanced detection
- Beautiful real-time console interface with progress tracking
- Fast concurrent checking with customizable concurrency
- Category-based filtering of websites
- Support for custom website lists (local and remote) in WhatsMyName format
- Proxy support with configurable settings
- Self-test functionality to validate detection methods
- Weak matching mode for fuzzy detection

## 🚀 Installation

```bash
pip install naminter
```

Or install from source:

```bash
git clone https://github.com/username/naminter.git
cd naminter
pip install -e .
```

## 💡 Usage

Basic usage:

```bash
naminter username
```

Advanced usage with options:

```bash
naminter username \
    --max-tasks 50 \
    --timeout 30 \
    --impersonate chrome \
    --include-categories social,tech \
    --proxy http://proxy:8080
```

### 🎯 Command Line Options

| Option | Description |
|--------|-------------|
| `username` | Username to check |
| `-m, --max-tasks` | Maximum concurrent tasks (default: 50) |
| `-t, --timeout` | Request timeout in seconds (default: 30) |
| `-i, --impersonate` | Browser to impersonate (chrome/safari/edge) |
| `-ic, --include-categories` | Categories to include |
| `-ec, --exclude-categories` | Categories to exclude |
| `-p, --proxy` | Proxy URL |
| `-l, --local-list` | Path to local website list |
| `-r, --remote-url` | URL to remote website list |
| `-w, --weak` | Enable weak matching mode |
| `--allow-redirects` | Allow HTTP redirects |
| `--verify-ssl` | Verify SSL certificates |
| `--self-test` | Run self-test mode |
| `-d, --debug` | Enable debug output |

## 📝 Configuration

### Categories

Available website categories:
- Social
- Gaming
- Tech
- Business
- Art
- Blog
- Dating
- Finance
- Health
- Images
- Music
- News
- Shopping
- Video
- And more...

### Browser Impersonation

Supported browser profiles:
- Chrome (Desktop)
- Chrome (Android)
- Safari (Desktop)
- Safari (iOS)
- Edge
- None

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/3xp0rt/Naminter",
    "name": "Naminter",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": "3xp0rt",
    "author_email": "contact@3xp0rt.com",
    "download_url": "https://files.pythonhosted.org/packages/30/61/06c979161962b99e86d03e1b17f89eee95c168719f299f41b7fbd0706ddd/naminter-1.0.0.tar.gz",
    "platform": null,
    "description": "# \ud83d\udd0d Naminter\n\n[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\nThe most powerful and fast username availability checker that searches across hundreds of websites using [WhatsMyName](https://github.com/WebBreacher/WhatsMyName) dataset. Naminter features full support of WhatsMyName data scheme, a beautiful console interface, browser impersonating, concurrent checking, and extensive configuration options.\n\n![Naminter Demo](demo.gif)\n\n## \u2728 Features\n\n- Full support of [WhatsMyName](https://github.com/WebBreacher/WhatsMyName) data scheme and updates\n- Check username availability across 600+ websites from WhatsMyName database\n- Accurate browser impersonation for enhanced detection\n- Beautiful real-time console interface with progress tracking\n- Fast concurrent checking with customizable concurrency\n- Category-based filtering of websites\n- Support for custom website lists (local and remote) in WhatsMyName format\n- Proxy support with configurable settings\n- Self-test functionality to validate detection methods\n- Weak matching mode for fuzzy detection\n\n## \ud83d\ude80 Installation\n\n```bash\npip install naminter\n```\n\nOr install from source:\n\n```bash\ngit clone https://github.com/username/naminter.git\ncd naminter\npip install -e .\n```\n\n## \ud83d\udca1 Usage\n\nBasic usage:\n\n```bash\nnaminter username\n```\n\nAdvanced usage with options:\n\n```bash\nnaminter username \\\n    --max-tasks 50 \\\n    --timeout 30 \\\n    --impersonate chrome \\\n    --include-categories social,tech \\\n    --proxy http://proxy:8080\n```\n\n### \ud83c\udfaf Command Line Options\n\n| Option | Description |\n|--------|-------------|\n| `username` | Username to check |\n| `-m, --max-tasks` | Maximum concurrent tasks (default: 50) |\n| `-t, --timeout` | Request timeout in seconds (default: 30) |\n| `-i, --impersonate` | Browser to impersonate (chrome/safari/edge) |\n| `-ic, --include-categories` | Categories to include |\n| `-ec, --exclude-categories` | Categories to exclude |\n| `-p, --proxy` | Proxy URL |\n| `-l, --local-list` | Path to local website list |\n| `-r, --remote-url` | URL to remote website list |\n| `-w, --weak` | Enable weak matching mode |\n| `--allow-redirects` | Allow HTTP redirects |\n| `--verify-ssl` | Verify SSL certificates |\n| `--self-test` | Run self-test mode |\n| `-d, --debug` | Enable debug output |\n\n## \ud83d\udcdd Configuration\n\n### Categories\n\nAvailable website categories:\n- Social\n- Gaming\n- Tech\n- Business\n- Art\n- Blog\n- Dating\n- Finance\n- Health\n- Images\n- Music\n- News\n- Shopping\n- Video\n- And more...\n\n### Browser Impersonation\n\nSupported browser profiles:\n- Chrome (Desktop)\n- Chrome (Android)\n- Safari (Desktop)\n- Safari (iOS)\n- Edge\n- None\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A description of your package and CLI tool",
    "version": "1.0.0",
    "project_urls": {
        "Homepage": "https://github.com/3xp0rt/Naminter"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "82dba7b0753558ecb2a37665637f95fcc54f6857320ccd3d3ca79c39c728dac7",
                "md5": "32a771abc48a4ba1c9e1614079566c7c",
                "sha256": "724f5f97244f4341e2d13bcb4ec7a44f93af7f0a3a52ae1211a17658c3a9df64"
            },
            "downloads": -1,
            "filename": "Naminter-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "32a771abc48a4ba1c9e1614079566c7c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 12857,
            "upload_time": "2025-02-10T02:47:38",
            "upload_time_iso_8601": "2025-02-10T02:47:38.227192Z",
            "url": "https://files.pythonhosted.org/packages/82/db/a7b0753558ecb2a37665637f95fcc54f6857320ccd3d3ca79c39c728dac7/Naminter-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "306106c979161962b99e86d03e1b17f89eee95c168719f299f41b7fbd0706ddd",
                "md5": "34d80382d8f8ba7ffcc2930225cba9ca",
                "sha256": "57f2286b0e7763a9ada144e5ef126a8cd7d076987df05d2a9a20c7f6fde2db13"
            },
            "downloads": -1,
            "filename": "naminter-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "34d80382d8f8ba7ffcc2930225cba9ca",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 11342,
            "upload_time": "2025-02-10T02:47:40",
            "upload_time_iso_8601": "2025-02-10T02:47:40.281307Z",
            "url": "https://files.pythonhosted.org/packages/30/61/06c979161962b99e86d03e1b17f89eee95c168719f299f41b7fbd0706ddd/naminter-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-10 02:47:40",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "3xp0rt",
    "github_project": "Naminter",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "naminter"
}
        
Elapsed time: 0.96816s