Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/master'
Browse files Browse the repository at this point in the history
  • Loading branch information
Udhayarajan committed Jan 27, 2023
2 parents 078769a + 6e81be5 commit 8187b51
Showing 1 changed file with 46 additions and 21 deletions.
67 changes: 46 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,54 @@
# VidSnapKit-Ultimate
Same as VidSnapKit but multi-platform project with JVM jar an android aar support. Social media post downloading library wriiten in Kotlin for Android and JVM machines. Compatible with Java projects too.
# VidSnapKit
VidSnapKit is a Kotlin Multi-Platform library that allows users to download videos from Instagram (Reels, Stories, Carousel Posts), Facebook, DailyMotion, LinkedIn, ShareChat, and Vimeo. The library is built with support for Android and JVM, and can be easily included in other Java/Kotlin projects or Android apps.

Add below lines to your gradle file.
## Installation
Add the following dependency to your app's build.gradle file:

dependencies {
...
implementation 'io.github.udhayarajan:VidSnapKit:<LATEST_VERSION>'
}

You can see `LATEST_VERSION` from release of this current respository.

NOTE: You no need to add beta `v` and `beta` tag in implementaion line. Just add numerical version alone (eg: `v2.0.1-beta` as `implementation 'io.github.udhayarajan:VidSnapKit:2.0.1`)
implementation 'io.github.udhayarajan:VidSnapKit:<release_version>'

Also make sure to include `mavenCentral()` repository
You can see LATEST_VERSION from release of this current respository.

NOTE: You no need to add `v` and `beta` tag in implementaion line. Just add numerical version alone (eg: v2.0.1-beta as implementation `'io.github.udhayarajan:VidSnapKit:2.0.1'`)

repositories {
mavenCentral()
}
Sync your project with Gradle.


## Supported:
- Instagram(Reels, Stories, Carousel Post, Image Post)
- Facebook
- DailyMotion
- LinkedIn
- ShareChat
- Vimeo
## Usage
To download a video, call the downloadVideo function with the URL of the video and the platform it is from (Instagram, Facebook, DailyMotion, LinkedIn, ShareChat, or Vimeo) and cookies if applicable.


val extractor = Extractor.findExtractor("https://www.instagram.com/p/B_5qXN6j5sd")
extractor?.let {
cookies?.let { cookie ->
it.cookies = cookie
}
it.start { res ->
//Get data from here
}
}
The function will return a Extractor object representing the extracted video.

## Note
- Make sure you have the necessary permissions to download the video.
- The library is intended for personal use only and should not be used for copyright infringement.
- The library is for educational and testing purposes and is not intended for commercial use.

## Contributing
If you want to contribute to this project, feel free to open a pull request or create an issue.

## Support
If you have any issues or questions, please open an issue.

## License
This project is licensed under the Apache 2.0 License.

## Author
This project is created by [Udhayarajan M](https://linktr.ee/udhayarajan_m)

## Resources
A sample app using this library can be found at this URL: https://github.com/Udhayarajan/VidSnapKit/tree/master/sample%20app

## Additional things
You can check the sample app for more details on how to use this library
Cookies can be applied if applicable.

0 comments on commit 8187b51

Please sign in to comment.