Compare commits

...

22 Commits
1.2.0 ... 1.4.0

Author SHA1 Message Date
Richard Mwewa
fe16b23fc7 Update banner.py 2022-03-31 12:54:23 +02:00
Richard Mwewa
8156af38d5 Update main.py 2022-03-31 12:53:29 +02:00
Richard Mwewa
6fb6a0ec98 Update main.py 2022-03-28 13:33:54 +02:00
Richard Mwewa
dc2a22aae0 Update dependabot.yml 2022-03-28 13:22:03 +02:00
Richard Mwewa
a2aac88da3 Create dependabot.yml 2022-03-28 13:09:04 +02:00
Richard Mwewa
3dbfc0f18e Update README.md 2022-03-28 12:52:56 +02:00
Richard Mwewa
392b3022d7 Update main.py 2022-03-27 23:01:12 +02:00
Richard Mwewa
162d36d741 Update main.py 2022-03-27 22:52:44 +02:00
Richard Mwewa
49490ed95b Update README.md 2022-03-27 22:49:42 +02:00
Richard Mwewa
78966551ee Update main.py 2022-03-27 22:47:47 +02:00
Richard Mwewa
a939b89d23 Update requirements.txt 2022-03-27 22:32:08 +02:00
Richard Mwewa
f79ce44bc9 Update colors.py 2022-03-27 22:31:04 +02:00
Richard Mwewa
7e45fa5669 Update banner.py 2022-03-27 22:27:57 +02:00
Richard Mwewa
f55e1b3895 Update README.md 2022-03-27 22:22:15 +02:00
Richard Mwewa
1ea78c2e0b Update README.md 2022-03-27 22:21:30 +02:00
Richard Mwewa
2272e7ff81 Update main.py 2022-03-27 22:13:08 +02:00
Richard Mwewa
44ce7799f4 Update README.md 2022-03-17 21:33:31 +02:00
Richard Mwewa
6c6fc477f8 v1.2.0 2022-03-17 21:27:39 +02:00
Richard Mwewa
d7060e33dd v1.2.0 2022-03-17 21:25:26 +02:00
Richard Mwewa
b47b073af4 Create requirements.txt 2022-03-17 21:22:10 +02:00
Richard Mwewa
4f196660bc v1.2.0 2022-03-17 21:21:15 +02:00
Richard Mwewa
e073d63845 v1.2.0 2022-03-17 21:13:00 +02:00
6 changed files with 98 additions and 47 deletions

13
.github/dependabot.yml vendored Normal file
View File

@@ -0,0 +1,13 @@
# To get started with Dependabot version updates, you'll need to specify which
# package ecosystems to update and where the package manifests are located.
# Please see the documentation for all configuration options:
# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
version: 2
updates:
# Enable version updates for pip
- package-ecosystem: "pip"
directory: "/" # Location of package manifests
# Check the tqdm registry for updates every day (weekdays)
schedule:
interval: "daily"

View File

@@ -4,65 +4,92 @@
![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/rly0nheart/octosuite?style=for-the-badge&logo=github) ![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/rly0nheart/octosuite?style=for-the-badge&logo=github)
![OS](https://img.shields.io/badge/OS-GNU%2FLinux-red?style=for-the-badge&logo=Linux) ![OS](https://img.shields.io/badge/OS-GNU%2FLinux-red?style=for-the-badge&logo=Linux)
![OS](https://img.shields.io/badge/OS-Windows-blue?style=for-the-badge&logo=Windows) ![OS](https://img.shields.io/badge/OS-Windows-blue?style=for-the-badge&logo=Windows)
![OS](https://img.shields.io/badge/OS-Mac-blue?style=for-the-badge&logo=apple)
![GitHub](https://img.shields.io/github/license/rly0nheart/octosuite?style=for-the-badge&logo=github) ![GitHub](https://img.shields.io/github/license/rly0nheart/octosuite?style=for-the-badge&logo=github)
![Lines of code](https://img.shields.io/tokei/lines/github/rly0nheart/octosuite?style=for-the-badge&logo=github)
![GitHub repo size](https://img.shields.io/github/repo-size/rly0nheart/octosuite?style=for-the-badge&logo=github) ![GitHub repo size](https://img.shields.io/github/repo-size/rly0nheart/octosuite?style=for-the-badge&logo=github)
> *Simply gather OSINT on Github users and organizations like a god🔥* > *Simply gather OSINT on Github users and organizations like a god🔥*
# FEATURES
- [x] Fetches organization info
- [x] Fetches user info
- [x] Fetches repository info
- [x] Returns contents of a path from a repository
- [x] Returns a list of repos owned by an organization
- [x] Returns a list of repos owned by a user
- [x] Returns a list of gists owned by a user
- [x] Returns a list of a user's followers
- [x] Checks whether user A follows user B
- [x] Searches users
- [x] Searches repositories
- [x] Searches topics
- [x] Searches issues
- [x] Searches commits
- [x] Easily updates with the 'update' command
- [x] Automatically logs network activity (.logs folder)
# INSTALLATION # INSTALLATION
**clone project**: **clone project**:
``` ```
$ git clone https://github.com/rly0nheart/octosuite.git git clone https://github.com/rly0nheart/octosuite.git
``` ```
``` ```
$ cd octosuite cd octosuite
```
```
pip install -r requirements.txt
``` ```
# USAGE # USAGE
**Linux**: **Linux**:
``` ```
$ sudo chmod +x octosuite sudo chmod +x octosuite
``` ```
``` ```
$ ./octosuite sudo ./octosuite
``` ```
**Windows**: **Windows**:
``` ```
$ python3 octosuite python3 octosuite
```
**Mac**:
```
python3 octosuite
``` ```
# AVAILABLE COMMANDS # AVAILABLE COMMANDS
| Command | Usage| | Command | Usage|
| ------------- |:---------:| | ------------- |:---------:|
| <code>orginfo</code> | *get organization info* | | ``orginfo`` | *get organization info* |
| <code>userinfo</code> | *get user profile info* | | ``userinfo`` | *get user profile info* |
| <code>repoinfo</code> | *get repository info* | | ``repoinfo`` | *get repository info* |
| <code>pathcontents</code> | *get contents of a path from a specified repository* | | ``pathcontents`` | *get contents of a path from a specified repository* |
| <code>orgrepos</code> | *get a list of repositories owned by a specified organization* | | ``orgrepos`` | *get a list of repositories owned by a specified organization* |
| <code>userrepos</code> | *get a list of repositories owned by a specified user* | | ``userrepos`` | *get a list of repositories owned by a specified user* |
| <code>usergists</code> | *get a list of gists owned by a specified user* | | ``usergists`` | *get a list of gists owned by a specified user* |
| <code>userfollowers</code> | *get a list of a user's followers* | | ``userfollowers`` | *get a list of a user's followers* |
| <code>userfollowing</code> | *check whether user A follows user B* | | ``userfollowing`` | *check whether user A follows user B* |
| <code>usersearch</code> | *search user(s)* | | ``usersearch`` | *search user(s)* |
| <code>reposearch</code> | *search repositor(y)(ies)* | | ``reposearch`` | *search repositor(y)(ies)* |
| <code>topicsearch</code> | *search topics(s)* | | ``topicsearch`` | *search topics(s)* |
| <code>issuesearch</code> | *search issue(s)* | | ``issuesearch`` | *search issue(s)* |
| <code>commitsearch</code> | *search commit(s)* | | ``commitsearch`` | *search commit(s)* |
| <code>usersearch</code> | *search user(s)* | | ``update`` | *update octosuite* |
| <code>update</code> | *check for/download updates* | | ``changelog`` | *show changelog* |
| <code>author</code> | *show author info* | | ``author`` | *show author info* |
| <code>help</code> | *show usage/help* | | ``help`` | *show usage/help* |
| <code>exit</code> | *exit session* | | ``exit`` | *exit session* |
# NOTE # NOTE
* *octosuite automatically logs network and minor user activity. The logs are saved by date and time in .logs folder* * *octosuite automatically logs network and minor user activity. The logs are saved by date and time in .logs folder*
* *octosuite has only been tested on **Termux** *and* **Kali Linux** (for now), please be sure to let me know how it works on **Windows*** * *Although octosuite was developed to work on **Mac**, **Windows**, or any **Linux** *Distribution*, it has only been tested on **Termux** *and* **Kali Linux***
# LICENSE # LICENSE
![license](https://user-images.githubusercontent.com/74001397/137917929-2f2cdb0c-4d1d-4e4b-9f0d-e01589e027b5.png) ![license](https://user-images.githubusercontent.com/74001397/137917929-2f2cdb0c-4d1d-4e4b-9f0d-e01589e027b5.png)

View File

@@ -7,7 +7,7 @@ banner = f'''{red}
░ ████▓▒░▒ ▓███▀ ░ ▒██▒ ░ ░ ████▓▒░▒██████▒▒▒█████▓ ░██░ ▒██▒ ░ ░▒████▒ ░ ████▓▒░▒ ▓███▀ ░ ▒██▒ ░ ░ ████▓▒░▒██████▒▒▒█████▓ ░██░ ▒██▒ ░ ░▒████▒
░ ▒░▒░▒░ ░ ░▒ ▒ ░ ▒ ░░ ░ ▒░▒░▒░ ▒ ▒▓▒ ▒ ░░▒▓▒ ▒ ▒ ░▓ ▒ ░░ ░░ ▒░ ░ ░ ▒░▒░▒░ ░ ░▒ ▒ ░ ▒ ░░ ░ ▒░▒░▒░ ▒ ▒▓▒ ▒ ░░▒▓▒ ▒ ▒ ░▓ ▒ ░░ ░░ ▒░ ░
░ ▒ ▒░ ░ ▒ ░ ░ ▒ ▒░ ░ ░▒ ░ ░░░▒░ ░ ░ ▒ ░ ░ ░ ░ ░ ░ ▒ ▒░ ░ ▒ ░ ░ ▒ ▒░ ░ ░▒ ░ ░░░▒░ ░ ░ ▒ ░ ░ ░ ░ ░
░ ░ ░ ▒ ░ ░ ░ ░ ░ ▒ ░ ░ ░ ░░░ ░ ░ ▒ v1.1.0 ░ ░ ░ ▒ ░ ░ ░ ░ ░ ▒ ░ ░ ░ ░░░ ░ ░ ▒ v1.4.0
░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░ ░
{white}— Advanced Github {red}OSINT{white} Framework{reset} {white}— Advanced Github {red}OSINT{white} Framework{reset}

View File

@@ -1,9 +1,10 @@
import sys import sys
# Colors will be unavailable on non-linux machines
colors = True colors = True
machine = sys.platform # Detecting the os machine = sys.platform
if machine.lower().startswith(("os", "win", "darwin")): if machine.lower().startswith(("os", "win", "darwin")):
colors = False # Colors will not be displayed colors = False
if not colors: if not colors:
reset = red = white = green = "" reset = red = white = green = ""

2
requirements.txt Normal file
View File

@@ -0,0 +1,2 @@
tqdm
requests

View File

@@ -1,18 +1,13 @@
import os import os
import logging import logging
import requests
import platform import platform
import subprocess import subprocess
import urllib.request import urllib.request
from tqdm import tqdm
from pprint import pprint from pprint import pprint
from lib import colors,banner from lib import colors,banner
from datetime import datetime from datetime import datetime
try:
import requests
except ImportError:
print(f'{colors.white}[{colors.green}*{colors.white}] Installing requirement(s). Please wait...{colors.reset}')
subprocess.run(['pip', 'install', 'requests'],shell=False)
exit(f'{colors.white}[{colors.green}+{colors.white}] Installation complete. Re-run octosuite.{colors.reset}')
class octosuite: class octosuite:
def __init__(self): def __init__(self):
@@ -155,9 +150,6 @@ class octosuite:
# Author dictionary # Author dictionary
self.author_dict = {'Alias': 'rly0nheart', self.author_dict = {'Alias': 'rly0nheart',
'Country': 'Zambia, Africa', 'Country': 'Zambia, Africa',
'Github': 'https://github.com/rly0nheart',
'Twitter': 'https://twitter.com/rly0nheart',
'Facebook': 'https://fb.me/rly0nheart',
'About.me': 'https://about.me/rly0nheart'} 'About.me': 'https://about.me/rly0nheart'}
def on_start(self): def on_start(self):
@@ -200,6 +192,8 @@ class octosuite:
self.commits_search() self.commits_search()
elif command == 'update': elif command == 'update':
self.update() self.update()
elif command == 'changelog':
print(self.changelog())
elif command == 'author': elif command == 'author':
self.author() self.author()
elif command == 'help': elif command == 'help':
@@ -410,17 +404,27 @@ class octosuite:
# Update program # Update program
def update(self): def update(self):
logging.info('Checking for update(s)...') logging.info('Fetching updates...')
files_to_update = ['src/main.py','lib/banner.py','lib/colors.py','octosuite','LICENSE','README.md'] files_to_update = ['src/main.py','lib/banner.py','lib/colors.py','octosuite','.github/dependabot.yml','LICENSE','README.md','requirements.txt']
print(f'\n{colors.white}[{colors.green}*{colors.white}] Fetching update(s). Please wait...{colors.reset}',end='') for file in tqdm(files_to_update,desc=f'{colors.white}[{colors.green}*{colors.white}] Fetching updates...{colors.reset}'):
for file in files_to_update:
data = urllib.request.urlopen(f'https://raw.githubusercontent.com/rly0nheart/octosuite/master/{file}').read() data = urllib.request.urlopen(f'https://raw.githubusercontent.com/rly0nheart/octosuite/master/{file}').read()
with open(file, 'wb') as code: with open(file, 'wb') as code:
code.write(data) code.write(data)
code.close() code.close()
logging.info('Update complete.') logging.info('Update complete.')
exit(f'\n{colors.white}[{colors.green}+{colors.white}] Update complete. Re-run octosuite.{colors.reset}') exit(f'{colors.white}[{colors.green}+{colors.white}] Update complete. Re-run octosuite.{colors.reset}')
# Show changelog
def changelog(self):
# lol yes the changelog is hard coded
changelog_text = '''
v1.4.0 Changelog:
• Minor changes to the interface
'''
return changelog_text
# Author info # Author info
@@ -433,7 +437,10 @@ class octosuite:
def help(self): def help(self):
help = ''' help = '''
usage: help:
Command Descritption
------------ ---------------------------------------------------------
orginfo --> Get target organization info orginfo --> Get target organization info
userinfo --> Get target user profile info userinfo --> Get target user profile info
repoinfo --> Get target repository info repoinfo --> Get target repository info
@@ -448,7 +455,8 @@ usage:
topicsearch --> Search topic(s) topicsearch --> Search topic(s)
issuesearch --> Search issue(s) issuesearch --> Search issue(s)
commitsearch --> Search commit(s) commitsearch --> Search commit(s)
update --> Check for/download update(s) update --> Update octosuite
changelog --> Show changelog
author --> Show author info author --> Show author info
help --> Show usage/help help --> Show usage/help
exit --> Exit session exit --> Exit session
@@ -456,5 +464,5 @@ usage:
return help return help
# Set to automatically monitor and log network and user activity to .log folder # Set to automatically monitor and log network and user activity into the .logs folder
logging.basicConfig(filename=f'.logs/{datetime.now()}.log',format='[%(asctime)s] %(message)s',level=logging.DEBUG) logging.basicConfig(filename=f'.logs/{datetime.now()}.log',format='[%(asctime)s] %(message)s',level=logging.DEBUG)