Skip to content

sk7n4k3d/fedispace

FediSpace Logo

FediSpace

An AI-enhanced, premium Pixelfed client built with Flutter

CI Release License Flutter Dart

AI Powered 16 Languages Android


About

FediSpace is an AI-supercharged, Instagram-inspired client for Pixelfed -- the federated, privacy-friendly image sharing platform. It takes the original Pixelfed experience and boosts it with artificial intelligence: real-time post translation, AI-powered image editing, smart content discovery, and more -- all wrapped in a cyberpunk-inspired dark theme with smooth animations.


AI-Powered Features

FediSpace integrates AI at the core of the experience. You are not locked into any cloud provider.

Bring Your Own AI -- Local or Cloud

FediSpace works with any OpenAI-compatible API:

Provider Type Example
Ollama Local LLM Llama 3, Mistral, Gemma on your own machine
LM Studio Local LLM One-click local models with OpenAI-compatible server
LocalAI Self-hosted Docker-based, drop-in OpenAI replacement
OpenAI Cloud GPT-4o, GPT-4 Turbo
Any compatible API Custom Groq, Together AI, Mistral API, vLLM, etc.

100% privacy-friendly: Point FediSpace to your local Ollama instance and your data never leaves your network.

What AI Does

Feature Description
Auto-Translate Posts Instantly translate any post into your language
AI Image Editing Describe what you want changed and AI transforms your photos
Smart Translation Settings Configure auto-translate, choose target language, or translate on demand
16 Language UI The entire app interface adapts to your language

Features

Timeline and Posts

  • Instagram-style feed with infinite scroll and blur hash placeholders
  • Full-screen image viewer with pinch-to-zoom
  • Video playback with custom player controls
  • Carousel/gallery posts support
  • Like, comment, share, bookmark -- full social interactions
  • Post detail page with threaded replies
  • View edit history of modified posts

Post Creation

  • Gallery, Camera, and Video capture options
  • Story creation from gallery or camera

Stories

  • Story bar with avatar bubbles
  • Full-screen story viewer with progress indicators
  • Story creation from camera or gallery
  • Viewer count and list for your own stories
  • Auto-advance navigation

Discover and Search

  • Explore page with trending content
  • User search with real-time results
  • Hashtag search and tag-based timelines
  • Account discovery across the Fediverse

Direct Messages

  • Conversation list with unread indicators
  • Real-time messaging interface
  • Image/photo sharing in conversations (NEW)
  • New message with user search and recipient picker
  • Delete conversations with confirmation dialogs

Notifications

  • In-app notification polling with badge counts
  • Notification types: follows, likes, boosts, mentions
  • Tap to navigate to relevant content

Profile and Social

  • Rich user profiles with stats
  • Profile editing capabilities
  • Follow / Unfollow / Mute / Block actions
  • Report users with reason description
  • Follow requests management
  • Followers and following lists with pagination

Settings and Privacy

  • Content filters -- create and manage keyword filters
  • Muted and blocked accounts management
  • Domain blocks -- block entire instances
  • Bookmarks, liked posts, archived posts
  • Collections -- organize posts into collections

Internationalization (i18n)

Full multi-language support with 16 languages:

English, French, Spanish, German, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, Arabic, Hindi, Turkish, Polish, Ukrainian

  • In-app language picker
  • System locale detection
  • Persistent preference

UI and Design

  • Cyberpunk dark theme with neon accents, glassmorphism, gradients
  • Instagram-inspired layout with familiar navigation
  • Custom bottom navigation with animated transitions
  • Pull-to-refresh on all list views
  • Smooth loading indicators and skeleton screens
  • Responsive design across different screen sizes

Tech Stack

Technology Purpose
Flutter / Dart Cross-platform framework
OAuth2 Secure authentication
Notification Polling In-app notification service
SharedPreferences Local settings persistence
CachedNetworkImage Image caching and blur hash
Camera Photo and video capture
Flutter Secure Storage Encrypted credential storage

Installation

Prerequisites

  • Flutter SDK >=3.0.0
  • Android SDK (API 24+)
  • A Pixelfed instance account

Build from source

git clone https://github.com/sk7n4k3d/fedispace.git
cd fedispace
flutter pub get
flutter run
flutter build apk --release

Download

Check the Releases page for pre-built APKs.


Project Structure

lib/
  core/           API, auth, notifications, logging, translation
  l10n/           Internationalization (16 languages)
  models/         Data models (Account, Status, Story, etc.)
  routes/         Pages and screens
    bookmarks/    Saved posts
    followers/    Follow lists
    liked/        Liked posts
    messages/     Direct messages
    notifications/
    post/         Post creation and detail
    profile/      Profile, collections, archives, QR
    search/       Discover and search
    settings/     Settings, filters, blocks
    timeline/     Main feed
  themes/         Cyberpunk theme
  widgets/        Reusable components
  main.dart       App entry point

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feat/amazing-feature)
  3. Commit your changes (git commit -m 'feat: Add amazing feature')
  4. Push to the branch (git push origin feat/amazing-feature)
  5. Open a Pull Request

Credits

Resource Description
Pixelfed The federated image sharing platform
Feathr Original project base

License

MIT License -- Copyright (c) 2024-2026 sk7n4k3d

See LICENSE for full text.

About

#fedispace client for #Pixelfed

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors