LionSec · s-h-3-l-l · Sep 5, 2019 · Sep 5, 2019 · Sep 5, 2019 · Sep 5, 2019
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
diff --git a/.github/ISSUE_TEMPLATE/message-to-author.md b/.github/ISSUE_TEMPLATE/message-to-author.md
@@ -0,0 +1,10 @@
+---
+name: Message to author
+about: Send a message to the maintainers of the program.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+*Your message here*
diff --git a/.gitignore b/.gitignore
@@ -1,57 +1,4 @@
-# Byte-compiled / optimized / DLL files
 __pycache__/
-*.py[cod]
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-env/
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-*.egg-info/
-.installed.cfg
-*.egg
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*,cover
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
+maintenance/sorted.lst
+maintenance/tools.lst
+deb/
diff --git a/Changelog.txt b/Changelog.txt
diff --git a/LICENCE → LICENSE b/LICENCE → LICENSE
@@ -279,59 +279,6 @@ POSSIBILITY OF SUCH DAMAGES.
 
                      END OF TERMS AND CONDITIONS
 
-            How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    {description}
-    Copyright (C) {year}  {fullname}
-
-    This program is free software; you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License along
-    with this program; if not, write to the Free Software Foundation, Inc.,
-    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) year name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  {signature of Ty Coon}, 1 April 1989
-  Ty Coon, President of Vice
-
 This General Public License does not permit incorporating your program into
 proprietary programs.  If your program is a subroutine library, you may
 consider it more useful to permit linking proprietary applications with the

diff --git a/README.md b/README.md
@@ -1,47 +1,101 @@
-![katoolin](https://cloud.githubusercontent.com/assets/8742190/9415562/83397aae-4840-11e5-8f72-28dfffcc70a9.png)
-# katoolin
-Automatically install all Kali linux tools
+# katoolin3
+Katoolin3 brings all programs available in Kali Linux to Debian and Ubuntu.
 
-# Features
-- Add Kali linux repositories
-- Remove kali linux repositories
-- Install Kali linux tools
+### Description
+This program is a port of [katoolin](https://github.com/LionSec/katoolin) from [LionSec](https://github.com/LionSec) to python3. Katoolin3 offers several improvements over katoolin:
+- __Up to date packages__    
+The old katoolin uses an outdated package list. Katoolin3 always keeps its package list up to date.  
+_(Last updated: 18 Feb 2020)_
 
-# Requirements
-- Python 2.7
-- An operating system (tested on Ubuntu)
+- __Improved handling of missing packages__   
+The old katoolin breaks if a package isn't available in the repositories anymore. Katoolin3 detects those and simply ignores them.
 
-# Installation
-- sudo su
-- git clone https://github.com/LionSec/katoolin.git && cp katoolin/katoolin.py /usr/bin/katoolin
-- chmod +x /usr/bin/katoolin
-- sudo katoolin 
+- __Removal of packages__    
+You can now remove all packages installed by katoolin3 (individually or all at once).
 
-# Video
-https://www.youtube.com/watch?v=8VxCWVoZEEE
+- __Upgrading wont break your system anymore__   
+...because the Kali repositories only get enabled during the runtime of katoolin3.
 
-# Usage
-- Typing the number of a tool will install it
-- Typing 0 will install all Kali Linux tools
-- back : Go back
-- gohome : Go to the main menu
-- By installing armitage , you will install metasploit
+- __Better utilization of the APT ecosystem__   
+The old katoolin does potentially dangerous operations such as modifying and *deleting* important system configuration files. This has been changed.
 
-# Warning
-Before updating your system , please remove all Kali-linux repositories to avoid any kind of problem .
+- __Easier maintenance of Kalis packages__   
+The old katoolin makes it difficult to add new packages to the package list due to the way katoolin was programmed. Maintaining the package list is now a lot easier.
 
-# I have some questions!
+- __Cleaner code__   
+Due to poor code quality katoolin was unmaintainable and had to be rewritten from scratch. katoolin3 aims to be more readable and easier to maintain.
 
-Please visit https://github.com/LionSec/katoolin/issues
+### Warning for Ubuntu users
+Installing programs from repositories for different operating systems
+is generally considered dangerous!   
+Some packages might (and probably will) break
+your system. Be careful when installing the tools and don't blame katoolin3 for
+any inconveniences.   
+The optimal solution is to install specific tools from
+[tools.kali.org](https://tools.kali.org/tools-listing).     
+It is not recommended to install all tools.
 
-# Donations
-- Paypal : https://www.paypal.me/lionsec
-- skrill : [email protected]
+### Requirements
+- apt as a package manager
+- Python >= 3.5
+- Root privileges
+- sh, bash
+- python3-apt
 
+### Installation
+```bash
+git clone https://github.com/s-h-3-l-l/katoolin3;
+cd katoolin3;
+chmod +x ./install.sh;
+sudo ./install.sh;
+```
 
-# Contact
-- Website : https://neodrix.com
-- Youtube : https://youtube.com/inf98es
-- Facebook : https://facebook.com/in98
-- Twitter: @LionSec1
-- Email : [email protected]
+__Important:__ If you get the error ```Please install the python3-apt package```
+please make sure katoolin3 runs with exactly the same python3 version as the
+```python3-apt``` package. On modern distributions ```python3-apt``` is only for python3.7 and
+on older distributions ```python3-apt``` is only for python3.5. Katoolin3 has to be run accordingly
+with python3.7 or python3.5.
+
+### Usage
+The program flow of katoolin3 is realized by presenting
+a list of options that you can choose from.
+These lists look like that:  
+```
+0) ...  
+1) ...  
+2) ...
+```
+#### Installing tools
+To install a package enter the corresponding number.
+To install multiple packages at once specify a range like ```3-5```, a list like ```1,2,3``` or combine them like ```1,2,5-7,9```.
+You can also install all packages at once.
+
+#### Uninstalling tools
+This works just like installing except that you have to prepend a ```~``` before your selection. You can also uninstall all packages at once.
+
+#### Searching
+Katoolin3 supports searching the package cache.  
+ E.g. if you want to install some tools related to SQL injections you can go into the search menu and search for ```sql injection```.    
+ If you want to have specific information about a package just enter the package name in the same search menu.   
+
+
+
+*For more functionalities see the help dialogue inside the program.*
+
+### Updating
+To update your tool list execute  
+```bash
+chmod +x ./update.sh;
+sudo ./update.sh;
+```  
+
+### Something doesn't work?
+Hit me up on [Github](https://github.com/s-h-3-l-l/katoolin3/issues/new/choose).
+
+### Uninstalling
+To uninstall katoolin3 execute
+```bash
+chmod +x ./uninstall.sh;
+sudo ./uninstall.sh;
+```
+Uninstalling the Kali tools can be done inside katoolin3.
diff --git a/TODO b/TODO
@@ -0,0 +1 @@
+Maybe add manpage
diff --git a/_config.yml b/_config.yml
@@ -0,0 +1 @@
+theme: jekyll-theme-hacker
diff --git a/conf.sh b/conf.sh
@@ -0,0 +1,17 @@
+# Contains values used by all shell scripts #
+#############################################
+
+# The installation directory:
+DIR="/usr/local/bin";
+
+# The name of the program after installation:
+PROGRAM="katoolin3";
+
+# Show error message and quit:
+die(){
+    if [ "$*" ];
+    then
+        echo $*;
+    fi
+    exit 1;
+}
diff --git a/core/__init__.py b/core/__init__.py