Skip to content

cgarey2014/shell_notes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 

Repository files navigation

  █████████  █████               ████  ████  ██████   █████           █████                    
 ███░░░░░███░░███               ░░███ ░░███ ░░██████ ░░███           ░░███                     
░███    ░░░  ░███████    ██████  ░███  ░███  ░███░███ ░███   ██████  ███████    ██████   █████ 
░░█████████  ░███░░███  ███░░███ ░███  ░███  ░███░░███░███  ███░░███░░░███░    ███░░███ ███░░  
 ░░░░░░░░███ ░███ ░███ ░███████  ░███  ░███  ░███ ░░██████ ░███ ░███  ░███    ░███████ ░░█████ 
 ███    ░███ ░███ ░███ ░███░░░   ░███  ░███  ░███  ░░█████ ░███ ░███  ░███ ███░███░░░   ░░░░███
░░█████████  ████ █████░░██████  █████ █████ █████  ░░█████░░██████   ░░█████ ░░██████  ██████ 
 ░░░░░░░░░  ░░░░ ░░░░░  ░░░░░░  ░░░░░ ░░░░░ ░░░░░    ░░░░░  ░░░░░░     ░░░░░   ░░░░░░  ░░░░░░  

Shell Notes is a user-friendly terminal logging utility that gives you a clean, interactive interface to drop into shell sessions with full input/output logging. Whether you're auditing commands, studying terminal workflows, or keeping track of what you ran, Shell Notes makes logging simple and organized.


🧰 Features

  • 🖥️ Fully interactive shell environment with session logging
  • 📂 Timestamped log files organized and easy to access
  • 🔍 Review logs with a searchable, numbered menu system
  • 🗑️ Option to delete unwanted logs right from the interface
  • 🧼 Clean interface with screen clearing between menus
  • ⚙️ Ready on boot, waits silently until invoked

📦 Download ShellNotes v1.0 (right-click and open in new tab)


🚀 Installation

  1. Download and unzip the release archive:

    unzip shellnotes-v1.0.zip
    cd shellnotes-release
  2. Run the installation script:

    sudo ./install.sh
  3. Launch ShellNotes with:

    shellnotes

🗑️ To uninstall ShellNotes:

sudo ./scripts/uninstall.sh

🖥️ Usage

To start a new shell session with ShellNotes:

shellnotes
  • A new terminal window will launch.

  • Your full shell session will be recorded to a timestamped .cast file using asciinema.

To end the session, simply type:

exit

📋 Requirements

  • Python 3.x

  • A supported terminal emulator:

    • gnome-terminal

    • xfce4-terminal

    • xterm

    • konsole (if installed)

ℹ️ ShellNotes is a minimalist terminal session recorder designed for cybersecurity professionals, educators, and students to document shell activity with clean and portable log files.

About

A lightweight command-line notebook for Linux users to save and manage terminal sessions, review and search logs, and delete logs.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published