0x5t4l1n/NexTOR_IP_CHANGER
1
0
Fork 0
mirror of https://github.com/0x5t4l1n/NexTOR_IP_CHANGER.git synced 2026-05-26 19:56:30 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
90224542b70f6384b41cc9ed9414e872ad0a0bec
NexTOR_IP_CHANGER/KALI_SUBMISSION_CHECKLIST.md
T

7.5 KiB
Raw Blame History

Kali Linux Package Submission Checklist

Last Updated: 14 Apr 2026
Project: NexTOR IP Changer
Version: 1.1
Maintainer: Stalin

✅ Pre-Submission Requirements

Local Setup

  • Install required tools:

    sudo apt-get install -y git git-buildpackage debhelper devscripts \
  pristine-tar build-essential dh-python python3-setuptools lintian \
  gnupg

  • Generate/verify GPG key:

    gpg --list-keys
# If no key exists:
gpg --gen-key

  • Configure git (if not done):

    git config --global user.name "Stalin"
git config --global user.email "stalin@example.com"
git config --global user.signingkey <YOUR_KEY_ID>

Package Files Updated

  • debian/control - Updated with Kali VCS fields
  • debian/changelog - Added Kali 1.1-1kali1 entry
  • debian/README.Debian - Created with Debian-specific docs
  • .gitlab-ci.yml - Created for Kali CI/CD
  • .git-buildpackagerc - Created for gbp configuration

📋 Current Status

Completed ✅

Next Steps 👉

  1. Create Kali account + request repo access
  2. Test local package build
  3. Fork Kali repo or contact Kali team
  4. Submit merge request or formal request

🔧 Build & Test Locally (BEFORE SUBMISSION)

Test Build Package

cd /home/w4nn4d13/Downloads/nextor-1.1

# Build the package
gbp buildpackage --git-ignore-new -us -uc

# Check for lintian errors
lintian -i nextor_1.1-1kali1_all.deb

Install & Test

# Install the built package
sudo apt-get install ./nextor_1.1-1kali1_all.deb

# Verify installation
nextor --help

# Check dependencies
dpkg -l | grep -E 'tor|python3-stem|python3-requests'

🚀 Kali Submission Process

Option 1: Submit via Kali Merge Request (Recommended)

  1. Create Kali GitLab Account

  2. Request Kali Package Maintainer Access

  3. Fork/Create in Kali Repository

    # Once you have access, fork:
# https://gitlab.com/kali-team/packages/

# Clone to local
git clone https://gitlab.com/YOUR_USERNAME/nextor.git
cd nextor

  4. Add Upstream Remote

    git remote add upstream https://gitlab.com/5t4l1n/NexTOR_IP_CHANGER.git
git fetch upstream

  5. Prepare for Merge Request

    # Create feature branch
git checkout -b add-nextor-package

# Copy your debian files
cp -r /path/to/nextor-1.1/debian ./
cp /path/to/nextor-1.1/.gitlab-ci.yml ./
cp /path/to/nextor-1.1/.git-buildpackagerc ./

# Commit with signature
git add debian/ .gitlab-ci.yml .git-buildpackagerc
git commit -S -m "Add NexTOR IP Changer package for Kali Linux"

# Push to your fork
git push origin add-nextor-package

  6. Submit Merge Request

    • Visit your forked repo on GitLab
    • Click "Merge Requests" → "New Merge Request"
    • Target: kali-team/packages/nextor:master
    • Fill in description: 
      **Package:** NexTOR IP Changer
**Version:** 1.1-1kali1
**Upstream:** https://gitlab.com/5t4l1n/NexTOR_IP_CHANGER.git
**Description:** 
Tor exit node IP address rotator for privacy and security testing

**Features:**
- Automatic IP rotation via Tor
- SOCKS5 proxy integration
- Command-line interface
- Lightweight and efficient

**Dependencies properly declared:** ✓
**Lintian checks pass:** ✓
**CI/CD pipeline configured:** ✓
**README.Debian provided:** ✓

  7. Wait for Review

    • Kali maintainers will review
    • They may request changes
    • Address feedback and push updates

Option 2: Direct Contact with Kali Team

Send professional email to: devel@kali.org

Subject: [PACKAGE REQUEST] NexTOR IP Changer - Tor IP Rotation Tool

Body:

Dear Kali Linux Development Team,

I would like to submit a new package for inclusion in the Kali Linux repository:

Package Name: nextor
Version: 1.1-1kali1
Upstream: https://gitlab.com/5t4l1n/NexTOR_IP_CHANGER.git
Description: Automated Tor exit node IP rotator for privacy/security testing

The package includes:
- Complete Debian packaging files
- CI/CD pipeline (.gitlab-ci.yml)
- Comprehensive documentation
- All dependencies properly declared
- Lintian compliance verified

Repository: https://gitlab.com/5t4l1n/NexTOR_IP_CHANGER.git

I'm ready to contribute and maintain this package.

Best regards,
Stalin

✅ Pre-Submission Quality Checklist

Before submitting, verify:

Code Quality

  • No syntax errors: python3 -m py_compile Nex_Tor_IP_changer/*.py
  • Proper Python 3.6+ compatibility
  • All imports available in Debian repos

Debian Standards

  • debian/control - Proper format and Kali VCS fields
  • debian/changelog - Properly formatted entry
  • debian/copyright - Correct license information
  • debian/rules - Proper permissions
  • debian/README.Debian - Documentation provided
  • No lintian errors: lintian -i nextor_*.deb

Dependencies

  • tor - Available in Kali
  • python3-requests - Available in Kali
  • python3-stem - Available in Kali
  • No proprietary dependencies

Documentation

  • README.md - Clear and comprehensive
  • Man page (nextor.1) - Properly formatted
  • LICENSE - MIT license included
  • MANIFEST.in - Correct file listing

Security

  • No sudo hardcoded
  • Proper file permissions
  • No credentials in source code
  • No deprecated security libraries

📞 Kali Linux Resources

🎯 After Acceptance

Once your package is accepted:

  1. Package Published

  2. Maintenance

    • Monitor for bug reports
    • Keep dependencies updated
    • Respond to security issues
    • Submit updates through Kali

  3. Version Updates

    • Tag releases: git tag v1.x
    • Update debian/changelog
    • Resubmit through MR process

📊 Submission Timeline

Typical timeline:

  • Package submission: Day 0
  • Initial review: 2-5 business days
  • Possible requests for changes: +2-3 days
  • Final approval: +1-2 days
  • Package in repos: Usually within 1 week

❓ FAQ

Q: Do I need Kali Linux installed?
A: Not required, but recommended for testing. Use Docker/VM with Debian Bullseye.

Q: Can I update the package after submission?
A: Yes, increment the version and resubmit as new MR.

Q: What if Kali team requests changes?
A: They'll comment in the MR; make changes and push to same branch.

Q: How long is maintenance required?
A: Indefinitely, but you can step down if needed (hand off to another maintainer).

Q: What about security vulnerabilities?
A: You should report/fix them promptly and submit updates.

🎉 Good Luck!

Your package looks solid. Follow these steps and it should be accepted smoothly.

For questions: Contact Kali development team or visit the forums.

Last checked: 14 Apr 2026

Reference in New Issue View Git Blame Copy Permalink