# space-radar

**Repository Path**: mirrors_JimLiu/space-radar

## Basic Information

- **Project Name**: space-radar
- **Description**: Disk And Memory Space Visualization App built with Electron & d3.js
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Space Radar Electron
====
SpaceRadar allows interactive visualization of disk space and memory. It currently supports Sunburst, Treemap, and Flamegraph charts.

Downloads
==
Download Mac and Windows at the [releases page](https://github.com/zz85/space-radar-electron/releases)

Features
==
- space visualizations using sunburst and treemap charts
- previews visualization as disk is being scanned
- fast (completes disk scanner faster than du)
- cross platform (at least on Mac OS X and Windows)
- allow drilldown of directories
- breadcrumbs and navigation
- opens files and directories
- analyze disk contents from a remote server (see section [Reading from a file](#reading-file))

Screenshots
==
![space-radar-4](https://cloud.githubusercontent.com/assets/314997/11022585/5c847364-869d-11e5-8079-0a16e7d747e4.gif)

![screenshot 2015-11-09 04 45 27](https://cloud.githubusercontent.com/assets/314997/11022582/3cc0bc90-869d-11e5-85c2-e79a0bf7c27f.png)

![screenshot 2015-11-09 04 45 36](https://cloud.githubusercontent.com/assets/314997/11022581/33822b50-869d-11e5-9fe6-2db6b7a81505.png)


Reading from a file <a id="reading-file"></a>
==
To create a file to be read from use `du -ak`, for example:
- `du -ak /var/log /usr | gzip -c > /tmp/sizes.txt.gz`
- `du -ak /opt /home /tmp > /tmp/sizes.txt`

Compressed files can be read directly. To detect them, the file name has to end with `.gz`.

Future Enhancements
==
- more target for scanning
- color by file types
- filter hidden files
- moar!!
- let me know what you think

Futher Explorations
==
- More efficient memory usage
- More efficient scanning process
- 3D visualization

History
==

This project started as quick prototype for me to test drive [atom electron](http://electron.atom.io) (& some es6 syntax), [d3.js](https://d3js.org) and for me to explore the question of "what's taking up my disk space". Turns out writing a disk visualization app isn't that simple as I dwell into figuring out how to make disk scanning not block the ui thread, ipc calls go faster, smoother rendering, lesser memory usage, more sensible interactions...


Whats New
==
V5
- Import from DU file
- Upgrade electron
- Flamegraphs (BETA)
- Directory Listview
- Update libs - Electron, D3

V4
- Treemap view
- Memory monitoring
- Mac App look using [Photon](http://photonkit.com)
- Context Menus for locating + opening + deleting files / directories
- Navigation controls (back/fwd/up)
- Switched disk scanning jobs to invisible renderer process

Version 3
- App icon finally! Thanks [Jill](http://jilln.com/) for the help with this :)
- Many Bug fixes
- Disk scanning is moved to a webview process
- Investigated various RPC methods. Now uses LocalStorage + FileSystem IPC message passing
- Reduce memory usage (and Electron crashes) by not caching key paths
- Tested on > 100GB & 2M files
- Improvements to user interactivity esp on hover states
- To prevent renderer process from hitting heap mem limit (1.5GB), all previous data is null, with dom elements removed to reduce memory pressure
- Allow target selection for disk usage scanning
- Locate path in Finder
- Env Debug Flags

Version 2
- Major speed up scanning directories. About 10x from version 1, and almost as fast or faster than du.
- Runs disk scanning as a separate headless renderer process
- Json is passed back via IPC
- Remove Async npm dependency

Issues
==
Please raise on [github issue tracker](https://github.com/zz85/space-radar-electron/issues) or contact [@blurspline on twitter](http://twitter.com/blurspline)

Development
==

Run

```
npm run debug
```

or

```
npm run app
```

Check that dependencies are installed, otherwise run (this may take awhile for electron binaries)

```
npm run install
```

Thanks
==
- [Jill](http://jilln.com/) for designing the app logo
- Jianwei for his comments on the app
- Chee Aun for helping alpha test the app
- WM for his talk on Electron that got me started
- [Contributors](https://github.com/zz85/space-radar/graphs/contributors)