A free, open-source iOS Mastodon client.
Go to file
Justin Mazzocchi 96d2ff3a2b Update README 2022-11-30 08:20:18 -08:00
.github Update README, CONTRIBUTING, PR template 2022-11-21 08:18:09 -08:00
Activities Link preferences 2021-02-06 00:07:23 -08:00
App Icons Add Malow app icon 2021-05-09 23:15:45 -07:00
Assets.xcassets Add icon 2020-09-09 18:45:43 -07:00
Caches Set retry and continue in background image options 2021-03-03 17:31:46 -08:00
DB Remove cleaning limit 2022-11-21 21:15:08 -08:00
Data Sources Fix jumping when restoring scroll position 2022-11-09 22:21:39 -08:00
Extensions Announcements 2021-04-25 22:24:17 -07:00
HTTP Cancel uploads 2021-01-03 15:57:40 -08:00
Keychain Keychain items accessible after first unlock 2021-01-05 15:39:03 -08:00
Localizations CrowdIn updates 2022-11-27 16:25:01 -08:00
Mastodon Parse dates without fractional seconds 2021-05-08 14:41:55 -07:00
MastodonAPI Resolve all searches 2021-05-09 22:10:14 -07:00
Metatext.xcodeproj Increment build number 2022-11-28 08:13:00 -08:00
Notification Service Extension Escape unicode in all URLs from API 2021-03-28 23:04:14 -07:00
Secrets Extract Base16 package 2021-02-27 15:34:49 -08:00
ServiceLayer Do not clean on main thread 2022-11-20 17:25:04 -08:00
Share Extension Settings refactor 2021-03-05 18:25:18 -08:00
Supporting Files Increment build number 2021-05-09 23:56:59 -07:00
System Fix iOS 15 nav bar appearance 2022-05-05 20:29:24 -07:00
Tests Modularize view models 2020-09-01 00:33:49 -07:00
Transitions Fix deprecation 2022-05-05 18:14:23 -07:00
View Controllers Debounce refresh when resuming from background 2022-11-27 22:59:52 -08:00
ViewModels Fix crash when muting account (#245) 2022-11-27 14:19:44 -08:00
Views Add preference to override color scheme / appearance (#142) 2022-11-13 12:03:19 -08:00
.gitignore Import and refactor stuff from old UIKit project 2020-07-31 00:13:54 -07:00
.swiftlint.yml Change swiftlint config 2021-03-21 16:26:07 -07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2021-03-13 21:31:15 -08:00
CONTRIBUTING.md Update README, CONTRIBUTING, PR template 2022-11-21 08:18:09 -08:00
LICENSE Create LICENSE 2021-03-13 21:30:36 -08:00
Metatext.xctestplan Add test plan 2021-04-01 00:08:43 -07:00
README.md Update README 2022-11-30 08:20:18 -08:00
SECURITY.md Update SECURITY.md 2021-03-31 18:16:58 -07:00



A free, open-source iOS Mastodon client.

Download on the App Store

Seeking Maintainers

Development of this project is currently paused. Email info@metabolist.org 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 and create a new one if the issue is not yet tracked.

Contributing Translations

You can help translate Metatext on CrowdIn.

Contributing Code

See the contribution guidelines.

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 info@metabolist.org first.


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 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 and change the pushSubscriptionEndpointURL constants in IdentityService.swift to its URL.


  • Metatext uses the Modelviewviewmodel (MVVM) architectural pattern.
  • 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.


Metatext uses the following third-party libraries:

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 http://www.wassenaar.org/ 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.


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 https://www.gnu.org/licenses/.