pimp-my-kali/README.md

198 lines
7.4 KiB
Markdown

# pimpmykali.sh
[![pmk1-3-2.png](https://i.postimg.cc/N0SDRyfX/pmk1-3-2.png)](https://postimg.cc/VS9X8kts)
# Fixes for new imported Kali Linux virtual machines
- Author assumes zero liability for any data loss or misuse of pimpmykali
- Can be used on a bare metal machines, but thats on you
- Menu breakdown added below revision history
# Github index updated added +x permission:
- Script is now be executable upon clone (perms: 755 rwxr-xr-x added to github)
- There is no need to chmod +x pimpmykali.sh upon git clone
# Installation script:
- rm -rf pimpmykali/
- git clone https://github.com/Dewalt-arch/pimpmykali
- cd pimpmykali
- sudo ./pimpmykali.sh
- For a new kali vm, run menu option N
# Special Thanks to Pimpmykali-Mirrors Testers!!
- Crazy_Man - https://github.com/The-Crazy-Man
- Andro - pimpmykali-mirrors testing
# Code Contributors
- blindpentester https://github.com/blindpentester
- pswalia2u https://github.com/pswalia2u
- Alek https://github.com/onomastus
- Gr1mmie https://github.com/Gr1mmie
- Aksheet https://github.com/Aksheet10
- 0xC0FFEE Home Lab Build
https://docs.google.com/document/d/1DH-epmXJMvQtOnDQYa3zUXvq9497Mm3276K8frNz2UM
# Revision 1.3.2 - Pimpmykali-Mirrors and updates
- Speedtest for kali linux repo mirrors (http only at this time)
- This function will only be executed via menu option =
- menu option = Pimpmykali-Mirrors (Yes it is literally the = (equals character)
- obtain kali mirror list and process
- round-trip-time ping test to all mirrors, select top 10 with shortest rtt
- small download >1MB from the top 10 mirrors, select top 5 fastest transfers
- large download 10MB test the final 5 mirrors, select fastest transfer
- generate new /etc/apt/sources.list with the new selected mirror
- prompt Y or N to write new changes to /etc/apt/sources.list
- Y writes changes /etc/apt/sources.list
- create backup of original sources.list in /etc/apt/sources.list_date_time
- write new deb and deb-src lines with new mirror to /etc/apt/sources.list
- N exits and makes no change to /etc/apt/sources.list
- added --mirrors for command line use sudo./pimpmykali.sh --mirrors
- new menu option T - set timezone (new function)
- calls sudo dpkg-reconfigure tzdata
- new menu option K - set keyboard, language, layout
- calls sudo dpkg-reconfigure keyboard-configuration
- menu option 6 - enable root login
- password prompt now checks exit code if failure, restart password function
- copy of files from /home/kali/* to /root now uses the actual username not just 'kali'
- fix_sources function updated to use wildcards
- Menu clean up, added bold color to "New VM Setup" Menu option N
- Added Sublime text editor installer - Menu Option L
- Revision History for 1.3.1 and 1.3.0 moved to changelog.txt
- Minor code cleanup
# Menu Breakdown of Pimpmykali
- Menu option N (New Users/New VM's Should start here!)
- executes menu option 0 fix all ( menu options 1 thru 8 )
- executes menu opiion 9 (pimpmyupgrade)
- Menu option = Pimpmykali-Mirrors (rev 1.3.2)
- obtain kali mirror list and process
- round-trip-time ping test to all mirrors, select top 10 with shortest rtt
- small download >1MB from the top 10 mirrors, select top 5 fastest transfers
- large download 10MB test the final 5 mirrors, select fastest transfer
- generate new /etc/apt/sources.list with the new selected mirror
- prompt Y or N to write new changes to /etc/apt/sources.list
- Y writes changes /etc/apt/sources.list
- create backup of original sources.list in /etc/apt/sources.list_date_time
- write new deb and deb-src lines with new mirror to /etc/apt/sources.list
- N exits and makes no change to /etc/apt/sources.list
- Menu Option 1 - Fix missing
- fix_sources
- uncomment #deb-src from /etc/apt/sources.list
- python-pip installation via curl
- python3-pip installed
- seclists installed
- gedit installed (feature request)
- flameshot installed (feature request)
- locate installed (feature request)
- fix_rockyou function
- gunzip /usr/share/wordlists/rockyou.gz to /usr/share/wordlists/rockyou.txt
- fix_golang function
- installs golang
- adds golang GOPATH to .bashrc and .zshrc
- installs htop
- installs python requests
- installs python xlrd==1.2.0
- disables xfce power management
- blacklists pcspkr kernel module /etc/modprobe.d/nobeep.conf
- Menu Option 2 - Fix smb.conf
- Fix /etc/samba/smb.conf
- adds client min protocol = CORE below [global]
- adds client max protocol = SMB3 below [global]
- Menu Option 3 - Fix Golang
- Installs golang
- checks for GOPATH in .bashrc and .zshrc
- if GOPATH is found, adds nothing
- if not found, adds GOPATH statements to both .zshrc and .bashrc
- Menu Option 4 - Fix Grub
- adds mitigations=off to GRUB_CMDLINE_LINUX_DEFAULT
- Menu Option 5
- installs Impacket-0.9.19
- Menu Option 6 - Enable root login
- installs kali-root-login
- prompts for root password
- copy /home/kali/* to /root prompt (1.1.2)
- prompt are you sure? to copy /home/kali to /root prompt (1.1.3)
- Menu Option 7
- installs Atom text editor
- Menu Option 8 - Fix Nmap
- wget nmap script fixes
- clamav-exec.nse
- http-shellshock.nse (Thank you Alek!)
- Menu Option 9 - Pimpmyupgrade
- additional notes will be added
- fix : Hypervisor detection (vmware, virtualbox, qemu/libvirt)
- add additional details here
- fix : virtualbox shared folder fix applied
- Menu Option 0 - Fix all (1-8)
- Executes ONLY Menu options 1 thru 8
- Menu Option P - Disable Power Management
- Based upon detection disable power management for that environment
- Detect desktop environment
- XFCE
- Gnome
- Menu Option F
- Fixes XFCE Broken Icons "TerminalEmulator" Not Found
- Fixes XFCE Open Catfish instead of Thunar when double clicking Home or FileSystem Icon
- this fix is a temporary fix and will be removed once xfce has been corrected
- Menu Option W
- Install GoWitness precompiled binary
- Menu Option G
- Apply gedit unable to open display as root fix
- Menu Option C
- Install Google-Chrome
- Menu Option V
- Install MS VSCode
- Menu Option S - Fix Spike
- Fixes undefined symbol error thrown when using generic_send_tcp
- this fix is temporary and will be removed once a corrected version is available
- Menu Option D - Downgrade metasploit-framework from 6 to 5
- downgrades metasploit-framework (msfconsole) from msf6 to msf5
- this is a temporary solution and will eventually be removed once a corrected version is available
- Menu Option ! - Nuke Impacket (yes its literally the ! character)
- removes any prior installation of impacket (gracefully and forcefully)
- installs impacket-0.9.19
- installs python-pip via curl
- installs python wheel
- Menu Option B
- BlindPentesters The_Essentials tools and utilities collection
- Install all of BlindPentesters favorite tools and utilities to /opt (aprox 8GB)
- Click the link below for a full list of the_essentials.sh script and its inner workings
- https://github.com/blindpentester/the-essentials
- Menu Option Q
- Set Qterminal for unlimited scrollback
- check for HistoryLimited=True in ~/.config/qterminal.org/qterminal.ini
- if found set HistoryLimited=False (unlimited scrollback)
- if already set to False, exit function
# TODO
- clean up todo list :)