-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'origin/master'
- Loading branch information
Showing
1 changed file
with
46 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) | ||
- DailyMotion | ||
- 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. |