https://github.com/noraj/miniss

Displays a list of open listening sockets. It is a minimal alternative to ss or netstat.
https://github.com/noraj/miniss

crystal crystal-shard crystal-shards ctf ctf-tools cyber cybersecurity hacking hacking-tool network pentest pentesting security security-tools shard shards socket tool

Last synced: 4 days ago
JSON representation

Displays a list of open listening sockets. It is a minimal alternative to ss or netstat.

• Host: GitHub
• URL: https://github.com/noraj/miniss
• Owner: noraj
• License: mit
• Created: 2023-02-26T15:13:04.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2025-01-27T00:37:01.000Z (3 months ago)
• Last Synced: 2025-04-12T05:38:12.312Z (4 days ago)
• Topics: crystal, crystal-shard, crystal-shards, ctf, ctf-tools, cyber, cybersecurity, hacking, hacking-tool, network, pentest, pentesting, security, security-tools, shard, shards, socket, tool
• Language: Crystal
• Homepage: https://noraj.github.io/miniss/
• Size: 213 KB
• Stars: 30
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-rainmana - noraj/miniss - Displays a list of open listening sockets. It is a minimal alternative to ss or netstat. (Crystal)

README

        
# miniss

![GitHub Workflow Status (with branch)](https://img.shields.io/github/actions/workflow/status/noraj/miniss/test.yml?branch=master&style=flat-square)

![GitHub License](https://img.shields.io/github/license/noraj/miniss?style=flat-square)

![GitHub top language](https://img.shields.io/github/languages/top/noraj/miniss?style=flat-square)

![GitHub commit activity](https://img.shields.io/github/commit-activity/y/noraj/miniss?style=flat-square)

![miniss logo](docs/logo-miniss.png)

**miniss** (_mini ss_) displays a list of open listening sockets. It is a minimal alternative to `ss` or `netstat`.

The goal of **miniss** is not to reinvent the wheel but rather to offer a static binary that can be deployed by pentester or CTF players on containers or hardened environment where the classical `ss` or `netstat` binaries have been removed.

![preview](docs/preview.png)

## Build

![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/noraj/miniss?sort=semver&style=flat-square)

![GitHub tag (latest SemVer pre-release)](https://img.shields.io/github/v/tag/noraj/miniss?include_prereleases&sort=semver&style=flat-square)

A pre-compiled static binary is provided only for `x86_64-linux-gnu`, see [releases](https://github.com/noraj/miniss/releases). Else read the [build](docs/build.md) instructions.

## Install

[![Packaging status](https://repology.org/badge/vertical-allrepos/miniss.svg)](https://repology.org/project/miniss/versions)

See [install](docs/install.md) instructions.

## Usage

```

miniss v0.0.2

Usage:

  miniss [--tcp | --udp] [--ipv4 | --ipv6] [--debug --no-color]

  miniss -h | --help

  miniss --version

Options:

  -u --udp      Show UDP sockets.

  -t --tcp      Show TCP sockets.

  -4 --ipv4     Show IPv4 sockets.

  -6 --ipv6     Show IPv6 sockets.

  --debug       Display arguments.

  --no-color    Disable colorized output (NO_COLOR environment variable is respected too).

  -h --help     Show this screen.

  --version     Show version.

Examples:

  miniss --udp

  miniss -t6

Project:

  author (https://pwn.by/noraj / https://twitter.com/noraj_rawsec)

  source (https://github.com/noraj/miniss)

  documentation (https://noraj.github.io/miniss)

```

## Features

- Information displayed:

  - type of socket, local address, remote address, state, username, uid

- Type of sockets:

  - [x] TCP

  - [x] UDP

- IP version:

  - [x] IPv4

  - [x] IPv6

## Documentation

Documentation homepage: https://noraj.github.io/miniss/

[![Library documentation](https://img.shields.io/badge/doc-library-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/lib-doc/Miniss.html)

[![User documentation - Build](https://img.shields.io/badge/doc-build-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/build)

[![User documentation - Install](https://img.shields.io/badge/doc-install-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/install)

[![User documentation - Changelog](https://img.shields.io/badge/doc-changelog-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/CHANGELOG)

[![Developer documentation - Contributing](https://img.shields.io/badge/doc-contributing-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/creating)

[![Developer documentation - Development](https://img.shields.io/badge/doc-development-black?logo=readthedocs&logoColor=black&style=flat-square)](https://noraj.github.io/miniss/development)

## Author

- [noraj](https://pwn.by/noraj/) - creator and maintainer