Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/metabolist/metatext
A free, open-source iOS Mastodon client.
https://github.com/metabolist/metatext
fediverse ios ios-app mastodon mastodon-app mastodon-client swift
Last synced: 3 months ago
JSON representation
A free, open-source iOS Mastodon client.
- Host: GitHub
- URL: https://github.com/metabolist/metatext
- Owner: metabolist
- License: gpl-3.0
- Archived: true
- Created: 2020-07-19T02:13:04.000Z (over 4 years ago)
- Default Branch: develop
- Last Pushed: 2022-12-22T22:42:49.000Z (almost 2 years ago)
- Last Synced: 2024-04-13T14:06:11.309Z (8 months ago)
- Topics: fediverse, ios, ios-app, mastodon, mastodon-app, mastodon-client, swift
- Language: Swift
- Homepage: https://metabolist.org/metatext
- Size: 3.3 MB
- Stars: 730
- Watchers: 20
- Forks: 99
- Open Issues: 149
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- fucking-open-source-ios-apps - Metatext
README
# Metatext
A free, open-source iOS Mastodon client.
[](https://apps.apple.com/us/app/metatext/id1523996615?mt=8)
## Seeking Maintainers
Development of this project is currently paused. Email [email protected] if you or your organization are interested in taking ownership of the project.
## Contributing Bug Reports
GitHub is used for bug tracking. Please search [existing issues](https://github.com/metabolist/metatext/issues) and create a new one if the issue is not yet tracked.
## Contributing Translations
You can help translate Metatext on [CrowdIn](https://crowdin.com/project/metatext).
## Contributing Code
See the [contribution guidelines](https://github.com/metabolist/metatext/blob/main/CONTRIBUTING.md).
Note that capacity for reviewing pull requests is currently very limited. For now, please limit the scope of proposed changes to fixing bugs and not added features, settings, or behavior, thanks. If you are interested in doing a larger scope change, please propose it via email at [email protected] first.
## Building
To build Metatext:
- Clone the repository (`git clone https://github.com/metabolist/metatext.git`)
- Open `Metatext.xcodeproj` in Xcode
- Select the top-level "Metatext" item in Xcode and change the team in each target's "Signing & Capabilities" settings to your own
All dependencies are managed using [Swift Package Manager](https://swift.org/package-manager) and will automatically be installed by Xcode.
### Push Notifications
Push notifications will not work in development builds of Metatext unless you host your own instance of [metatext-apns](https://github.com/metabolist/metatext-apns) and change the `pushSubscriptionEndpointURL` constants in [IdentityService.swift](https://github.com/metabolist/metatext/blob/main/ServiceLayer/Sources/ServiceLayer/Services/IdentityService.swift) to its URL.
## Architecture
- Metatext uses the [Model–view–viewmodel (MVVM) architectural pattern](https://en.wikipedia.org/wiki/Model–view–viewmodel).
- View models are clients of a service layer that abstracts network and local database logic.
- Different levels of the architecture are in different local Swift Packages. `import DB` and `import MastodonAPI` should generally only be done within the `ServiceLayer` package, and `import ServiceLayer` only within the `ViewModels` package.
## Acknowledgements
Metatext uses the following third-party libraries:
- [BlurHash](https://github.com/woltapp/blurhash)
- [CombineExpectations](https://github.com/groue/CombineExpectations)
- [GRDB](https://github.com/groue/GRDB.swift)
- [SDWebImage](https://github.com/SDWebImage/SDWebImage)
- [SQLCipher](https://github.com/sqlcipher/sqlcipher)
## Cryptography Notice
This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software.
BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted.
See for more information.
The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms.
The form and manner of this distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.
## License
Copyright (C) 2021 Metabolist
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see .