Skip to content

CapCeph/ship-lens

Repository files navigation

Ship Lens Logo

Ship Lens

A lightweight desktop damage calculator for Star Citizen

Latest Release License Downloads

Made By TheCeph for The Community


Table of Contents


What is Ship Lens?

Ship Lens is a fast, native desktop app that calculates Time-To-Kill (TTK) between Star Citizen ships. TTK is the time to reach power plant failure - the point of no return where the ship will explode if the pilot/crew doesn't eject or repair. No browser needed - just launch and go.

Accuracy Note: TTK values are typically accurate within 5 seconds based on testing against live Alpha 4.5 combat. Real fights vary based on pilot skill, hit rate, and maneuvering. Feedback is welcome!

Ship Lens Screenshot

Think of it as a variant of Erkul but as a lightweight desktop app built in Rust.

Current Support: Star Citizen Alpha 4.5 LIVE


Features

  • Answer "Can I Kill That?" - See exactly how long any fight takes before you engage
  • Every Flyable Ship - 307+ ships with accurate hull, armor, and shield stats
  • All Player Weapons - 145+ guns you can actually equip (no NPC/template junk)
  • Test Before You Die - Dogfight vs Jousting scenarios to plan your approach
  • See What Hurts - Breakdown of physical, energy, and distortion damage
  • Instant Results - Tweak loadouts and see TTK update live
  • Save Your Builds - Fleet presets for your favorite configurations
  • Rep Your Manufacturer - Crusader, Drake, MISC, Origin, and Aegis themes
  • Know Your Weapons - See exactly how each gun contributes: shield DPS, armor DPS, and solo TTK
  • Missile Math - Know how much time your torpedoes save before you waste them on the wrong target
  • Visual Damage Phases - Mini-timelines show each weapon's shield/armor/hull breakdown at a glance
  • Effectiveness Check - Instantly see which weapons can break shields vs which are just tickling
  • Torpedo Time Savings - See exactly how many seconds each missile salvo shaves off

What's New

v0.1.23 Highlights

  • Bug Fix: Duplicate Missile Display - Fixed missiles showing twice in Weapon Effectiveness section (once as "ACTIVE", once as "EFFECTIVE")
  • Affects 203 ships - 66% of ship database with missile/torpedo/bomb hardpoints now display correctly

View Full Changelog | All Releases


Installation

Linux

Fedora / RHEL:

curl -sLO https://github.com/CapCeph/ship-lens/releases/latest/download/Ship.Lens-0.1.23-1.x86_64.rpm && sudo dnf install -y ./Ship.Lens-*.rpm

Ubuntu / Debian / Zorin:

curl -sLO https://github.com/CapCeph/ship-lens/releases/latest/download/Ship.Lens_0.1.23_amd64.deb && sudo apt install -y ./Ship.Lens_*.deb

Windows

Download the .msi installer from the Releases page, run it, and launch "Ship Lens" from the Start Menu.

Note: Linux is the primary development platform. Windows builds are provided via GitHub Actions but may contain bugs or untested behavior. Please report any issues you encounter.

Manual Download

Download Latest Release

Platform File
Windows .msi / .exe
Fedora/RHEL .rpm
Ubuntu/Debian .deb

Building from Source

Click to expand build instructions

Prerequisites

Build

git clone https://github.com/CapCeph/ship-lens.git
cd ship-lens
npm install
npm run tauri build

Output will be in src-tauri/target/release/bundle/

Development

npm run tauri dev

Data Sources

Ship, weapon, and shield data is extracted from Star Citizen game files using scdatatools.

Data is updated periodically after major patches.


Legal Notice

This is an unofficial Star Citizen fan project, not affiliated with Cloud Imperium Games.

Star Citizen®, Roberts Space Industries®, and Cloud Imperium® are registered trademarks of Cloud Imperium Rights LLC.


License

MIT License - See LICENSE for details.

Trademark: "Ship Lens" is a trademark of TheCeph. Forks must use a different name.


New to Star Citizen?
Use referral code STAR-2DFQ-WXQ6 for bonus credits!