https://github.com/cranci1/osmium
An iOS/iPadOS client to interact with the cobalt API
https://github.com/cranci1/osmium
bibili collaboration downloader instagram instagram-reels ios-app music reddit social-media soundcloud swift tiktok twitter video vimeo vine vk youtube youtube-music
Last synced: 5 months ago
JSON representation
An iOS/iPadOS client to interact with the cobalt API
- Host: GitHub
- URL: https://github.com/cranci1/osmium
- Owner: cranci1
- License: agpl-3.0
- Created: 2024-05-28T13:09:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-08T13:52:57.000Z (5 months ago)
- Last Synced: 2025-05-13T13:17:27.108Z (5 months ago)
- Topics: bibili, collaboration, downloader, instagram, instagram-reels, ios-app, music, reddit, social-media, soundcloud, swift, tiktok, twitter, video, vimeo, vine, vk, youtube, youtube-music
- Language: Swift
- Homepage:
- Size: 13.5 MB
- Stars: 18
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/cranci1/Osmium/actions/workflows/swift.yml)
[](https://img.shields.io/badge/Platform-iOS%20%7C%20iPadOS%2014.2%2B-red?logo=apple&logoColor=white)
[](https://custom-icon-badges.demolab.com/github/v/release/cranci1/osmium)
[](https://custom-icon-badges.demolab.com/github/last-commit/cranci1/Osmium)
A free iOS mobile client to download publicly accessible items from various known platforms. Using the Cobalt API.
## Table of Contents
- [Important](#important)
- [Compatibility](#compatibility)
- [Supported Platforms](#supported-platforms)
- [Disclaimer](#disclaimer)
- [Acknowledgements](#acknowledgements)
## Important
As of October 20, 2024, the Cobal API now requires authentication for api usages. Starting from version 0.5, Osmium will require you to set up a custom instance with an API key to continue using the service. This is because i dont want to be classified as a bad actor in the Cobal community. My goal with this project has always been to simplify file downloads on iOS devices via Cobal. For instructions on creating a custom instance, please refer to [this guide](https://github.com/imputnet/cobalt/blob/main/docs/run-an-instance.md)
## Compatibility
Osmium is designed to support every device running iOS/iPadOS 14.2 or later.
> Note: The user experience may vary depending on the specific device model and its performance capabilities, and is heavily influenced by the network download speed!
## Disclaimer
As stated in the [Cobalt API Repository](https://github.com/imputnet/cobalt?tab=readme-ov-file#ethics-and-disclaimer):
```
Cobalt is NOT a piracy tool and cannot be used as such.
It can only download free, publicly accessible content.
Such content can be easily downloaded through any browser's dev tools.
```
Therefore, Osmium **is not a piracy tool** and will never be used as one.
## Supported Platforms
**Osmium** supports any platform supported by the [Cobalt API](https://github.com/imputnet/cobalt?tab=readme-ov-file#supported-services). Below is a list of supported services:
| Service | Video + Audio | Only Audio | Only Video | Metadata | Rich File Names |
| :----------------------------- | :-----------: | :--------: | :--------: | :------: | :-------------: |
| bilibili.com & bilibili.tv | ✅ | ✅ | ✅ | ➖ | ➖ |
| dailymotion | ✅ | ✅ | ✅ | ✅ | ✅ |
| instagram posts & reels | ✅ | ✅ | ✅ | ➖ | ➖ |
| loom | ✅ | ❌ | ✅ | ✅ | ➖ |
| ok video | ✅ | ❌ | ✅ | ✅ | ✅ |
| pinterest | ✅ | ✅ | ✅ | ➖ | ➖ |
| reddit | ✅ | ✅ | ✅ | ❌ | ❌ |
| rutube | ✅ | ✅ | ✅ | ✅ | ✅ |
| soundcloud | ➖ | ✅ | ➖ | ✅ | ✅ |
| streamable | ✅ | ✅ | ✅ | ➖ | ➖ |
| tiktok | ✅ | ✅ | ✅ | ❌ | ❌ |
| tumblr | ✅ | ✅ | ✅ | ➖ | ➖ |
| twitch clips | ✅ | ✅ | ✅ | ✅ | ✅ |
| twitter/x | ✅ | ✅ | ✅ | ➖ | ➖ |
| vimeo | ✅ | ✅ | ✅ | ✅ | ✅ |
| vine archive | ✅ | ✅ | ✅ | ➖ | ➖ |
| vk videos & clips | ✅ | ❌ | ✅ | ✅ | ✅ |
| youtube videos, shorts & music | ✅ | ✅ | ✅ | ✅ | ✅ |
| Emoji | Meaning |
| :-----: | :---------------------- |
| ✅ | Supported |
| ➖ | Impossible/Unreasonable |
| ❌ | Not Supported |
## Acknowledgements
Osmium would not exist without the help of the **Cobalt API**. Special thanks to the developer team of the Cobalt API, [imput](https://github.com/imputnet)