Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kapilyadav-dev/phasher

A perceptual hash is a fingerprint of a multimedia file derived from various features from its content. Unlike cryptographic hash functions which rely on the avalanche effect of small changes in input leading to drastic changes in the output, perceptual hashes are "close" to one another if the features are similar.
https://github.com/kapilyadav-dev/phasher

android androidlibrary image imageprocessing imagesimilarity javaphash kotlin kotlinphash phash phash-similarity similarity-score

Last synced: about 7 hours ago
JSON representation

Host: GitHub
URL: https://github.com/kapilyadav-dev/phasher
Owner: KapilYadav-dev
Created: 2022-09-02T15:49:06.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2022-09-28T09:16:21.000Z (about 2 years ago)
Last Synced: 2024-05-02T03:15:24.093Z (7 months ago)
Topics: android, androidlibrary, image, imageprocessing, imagesimilarity, javaphash, kotlin, kotlinphash, phash, phash-similarity, similarity-score
Language: Java
Homepage:
Size: 267 KB
Stars: 21
Watchers: 1
Forks: 4
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Phasher ✅

> So, around a week ago I was struggling to compare similarities between two images and found a way i.e Phash (perceptual hash) algorithm. It's based upon https://www.phash.org/.❤️

## ⌨️ Usage

![latestVersion](https://img.shields.io/github/v/release/KapilYadav-dev/Phasher)

### 1. Add dependency.
```groovy
repositories {
maven { url 'https://jitpack.io' } // Add jitpack
}

dependencies {
implementation 'com.github.KapilYadav-dev:Phasher:Tag'
}

```

### 2. Use Phash() function.
#### 1st way using file path.
```kotlin
fun Phash(
fileOnePath: String?, // path of Image one
fileTwoPath: String?, // path of Image two
bitSize: Int = 8 // This is the size you want to resize, can play with it for more accuracy and its best with the value 8
)
```
#### 2nd way using file uri.
```kotlin
fun Phash(
uriOne: Uri?, // Uri for Image one
uriTwo: Uri?, // Uri for Image two
context: Context
)
```
#### Finally use ```getSimilarityScore()``` method which will return % of confidence.
#### i.e.
```kotlin
val score = Phash(path1,path2).getSimilarityScore()
// score = 70 %
val scoreTwo = Phash(uri1,uri2,context).getSimilarityScore()
// score = 70%
```

## Important Note ✍️
Choose your threasold for your image as per your usecase.

For a standard one, we use 75 % threasold that means above its image are similar.
## ✍️ Author

👤 **mrkaydev**

* Linkedin: @mrkaydev
* Email: [email protected]

Feel free to ping me 😉

## 🤝 Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any
contributions you make are **greatly appreciated**.

1. Open an issue first to discuss what you would like to change.
1. Fork the Project
1. Create your feature branch (`git checkout -b feature/amazing-feature`)
1. Commit your changes (`git commit -m 'Add some amazing feature'`)
1. Push to the branch (`git push origin feature/amazing-feature`)
1. Open a pull request

Please make sure to update tests as appropriate.

## ❤ Show your support

Give a ⭐️ if this project helped you!

## 📝 License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```