Update README.

master
Ivan Olexyn 6 years ago
parent 7270d1cb4e
commit eeea54fd8c

@ -1,15 +1,28 @@
### What is `mucc`? ### About
`mucc` is an example for interactions between Linux, Java and JavaFX. mucc is a tool for processing data recovered by scalpel.
It is a tool for purging duplicates from It's features include:
a filesystem. 1. Splitting PDF files into sub-files.
2. Deleting duplicate files, which can be used independently.
It does this by calculating a hash of each file <br>
and sorting the files by hash. <br>
If two files have the same hash, the older file will be deleted.
It also displays some information about what is happening. ### How it Works
This ensures the user never suspects something went horribly wrong.
##### Retrieving Sub-Files
scalpel parses a disk image for %PDF headers
and %EOF footers.
If max_filsize is set high, the generated files will often consist of several
concatenated sub-files.
Here mucc finds the nested %PDF and %EOF tags
and returns the files with byte sized precision.
##### Deleting Duplicates
Here mucc calculates the md5 hash of each file and deletes the identical files.
<br>
<br>
### Contents of `src/app` ### Contents of `src/app`
@ -21,19 +34,18 @@ This ensures the user never suspects something went horribly wrong.
| layout.fxml | Contains layout data.| | layout.fxml | Contains layout data.|
| Main | Main JavaFX class. Run from here.| | Main | Main JavaFX class. Run from here.|
| QuicksortMd5 | Quicksort algorithm.| | QuicksortMd5 | Quicksort algorithm.|
| README.md | You are here.| | routines | Contains higher level routines called by Controller.|
| Routines | Higher level routines called by Controller.| | Tools | Simple tools used by other classes.|
| Tools | Simple tools.|
| Write | Writes to /tmp. Used for data storage.| | Write | Writes to /tmp. Used for data storage.|
### Issues and Features ### Issues and Features
- Add proper directory selection.
- Fix issues where nested duplicates would not be deleted on first pass. - Fix issues where nested duplicates would not be deleted on first pass.
- Make UI prettier.
- Make code prettier. - Make code prettier.
- Add scalpel integration.
- Replace "__" with progress indicators for states.
### Screenshot ### Screenshot
![UI](src/app/screen.png) ![UI](src/app/img/screen.png)

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

Loading…
Cancel
Save