Mixpost it's the coolest Self-hosted social media management software.
This package is the Lite version of Mixpost Pro, and by integrating it into your Laravel project, you can easily create, schedule, publish, and manage social media content in one place, with no limits or monthly subscription fees.
It's the perfect social media management solution for bloggers, crafters and entrepreneurs.
Mixpost Pro is under development and will be released soon. Sign up to be notified when it's released mixpost.app
Join our community:
- Laravel Framework [^9.0, ^10.0]
- PHP 8.1 or higher
- Database (eg: MySQL, PostgresSQL, SQLite)
- Redis 6.2 or higher
- Web Server (eg: Apache, Nginx, IIS)
- URL Rewrite (eg: mod_rewrite for Apache)
You may use Composer to install Mixpost into your new Laravel project:
composer require inovector/mixpostAfter installing the Mixpost package, you may execute:
php artisan mixpost:installMixpost uses Job Batching and you should create a database migration to build a table to contain meta information about your job batches.
If your application does not yet have this table, it may be generated using the:
php artisan queue:batches-tableRun the migrations with:
php artisan migrateYou can publish the config file with:
php artisan vendor:publish --tag=mixpost-configThis is the contents of the published config file:
return [
/*
* Mixpost will redirect unauthorized users to the route name specified here
*/
'redirect_unauthorized_users_to_route' => 'login',
/*
* The disk on which to store added files.
* Choose one or more of the disks you've configured in config/filesystems.php.
*/
'disk' => env('MIXPOST_DISK', 'public'),
/*
* Indicate that the uploaded file should be no more than the given number of kilobytes.
* Adding a larger file will result in an exception.
*/
'max_file_size' => [
'image' => 1024 * 5, // 5MB
'gif' => 1024 * 15, // 15MB
'video' => 1024 * 200 // 200MB
],
/*
* Accepted mime types for media library upload.
* These are all supported mime types for the image and video files. We do not guarantee that it will work with other types.
* If you need to remove certain mime types, you are free to do so from here.
*/
'mime_types' => [
'image/jpg',
'image/jpeg',
'image/gif',
'image/png',
'video/mp4'
],
/*
* The path where to store temporary files while performing image conversions.
* If set to null, storage_path('mixpost-media/temp') will be used.
*/
'temporary_directory_path' => null,
/*
* FFMPEG & FFProbe binaries paths, only used if you try to generate video thumbnails
*/
'ffmpeg_path' => env('FFMPEG_PATH', '/usr/bin/ffmpeg'),
'ffprobe_path' => env('FFPROBE_PATH', '/usr/bin/ffprobe'),
/*
* Define cache prefix
*/
'cache_prefix' => env('MIXPOST_CACHE_PREFIX', 'mixpost'),
/*
* Define log channel
* Captures connection errors with social networks or third parties used in Mixpost in a separate channel.
* Leave blank if you want to use Laravel's default log channel
*/
'log_channel' => env('MIXPOST_LOG_CHANNEL'),
/*
* The media component is integrated with third-party services Unsplash.com and Tenor.com
* Defines the default terms for displaying media resources
*/
'external_media_terms' => ['young', 'social', 'mix', 'content', 'viral', 'trend', 'test', 'light', 'true', 'false', 'marketing', 'self-hosted', 'ambient', 'writer', 'technology'],
/*
* Options for each social network
* We recommend leaving these options unchanged
* You only change them when the API policy of the social networks changes, and you know what you are doing.
*/
'social_provider_options' => [
'twitter' => [
'simultaneous_posting_on_multiple_accounts' => false,
'post_character_limit' => 280,
'media_limit' => [
'photos' => 4,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
],
'facebook_page' => [
'simultaneous_posting_on_multiple_accounts' => true,
'post_character_limit' => 5000,
'media_limit' => [
'photos' => 10,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
],
'facebook_group' => [
'simultaneous_posting_on_multiple_accounts' => true,
'post_character_limit' => 5000,
'media_limit' => [
'photos' => 10,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
],
'mastodon' => [
'simultaneous_posting_on_multiple_accounts' => true,
'post_character_limit' => 500,
'media_limit' => [
'photos' => 4,
'videos' => 1,
'gifs' => 1,
'allow_mixing' => false,
]
]
],
];Mixpost has the ability to generate images from video while uploading a video file. This would not be possible without FFmpeg installed on your server. You need to follow FFmpeg installation instructions on their official website.
After installation, depending on the operating system, you need to set the ffmpeg_path and ffprobe_path in the
Mixpost config file.
Default folder path: /usr/bin/. If FFmpeg is there, there is no need to change it.
/*
* FFMPEG & FFProbe binaries paths, only used if you try to generate video thumbnails
*/
'ffmpeg_path' => env('FFMPEG_PATH', '/usr/bin/ffmpeg'),
'ffprobe_path' => env('FFPROBE_PATH', '/usr/bin/ffprobe'),Mixpost handles various tasks in a queued way via Laravel Horizon. If your application doesn't have Horizon installed yet, follow their installation instructions.
After Horizon is installed, don't forget to set QUEUE_CONNECTION in your .env file to redis.
config/horizon.php should have been created in your project. In this config file, you must add a block
named mixpost-heavy to both the production and local environment.
'environments' => [
'production' => [
'supervisor-1' => [
'maxProcesses' => 10,
'balanceMaxShift' => 1,
'balanceCooldown' => 3,
],
'mixpost-heavy' => [
'connection' => 'mixpost-redis',
'queue' => ['publish-post'],
'balance' => 'auto',
'processes' => 3,
'tries' => 1,
'timeout' => 60 * 60,
],
],
'local' => [
'supervisor-1' => [
'maxProcesses' => 3,
],
'mixpost-heavy' => [
'connection' => 'mixpost-redis',
'queue' => ['publish-post'],
'balance' => 'auto',
'processes' => 3,
'tries' => 1,
'timeout' => 60 * 60,
],
],
],In the config/queue.php file you must add the mixpost-redis connection:
'connections' => [
// ...
'mixpost-redis' => [
'driver' => 'redis',
'connection' => 'default',
'queue' => env('REDIS_QUEUE', 'default'),
'retry_after' => 11 * 60,
'block_for' => null,
],Don't forget running php artisan horizon. In production, you need a way to keep your horizon processes running. For
this reason, you need to configure a process
monitor Supervisor that can detect when your horizon
processes exit and automatically restart them.
Example of supervisor config:
[program:mixpost_horizon]
process_name=%(program_name)s
command=php /path-to-your-project/artisan horizon
autostart=true
autorestart=true
user=your_user_name
redirect_stderr=true
stdout_logfile=/path-to-your-project/storage/logs/horizon.log
stopwaitsecs=3600In the console kernel (app/Console/Kernel.php), you should schedule this command.
protected function schedule(Schedule $schedule)
{
// ...
$schedule->command('mixpost:run-scheduled-posts')->everyMinute();
$schedule->command('mixpost:import-account-data')->everyTwoHours();
$schedule->command('mixpost:import-account-audience')->everyThreeHours();
$schedule->command('mixpost:process-metrics')->everyThreeHours();
$schedule->command('mixpost:delete-old-data')->daily();
}Don't forget to add a cron that running the scheduler:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
Mixpost does not come with any user management, we assume that you already provide this in your own app. You can use a gate check to determine who can access Mixpost.
However, we have created a separate package Mixpost Auth that you can install very easily. Read the documentation of this package to find out how to install it.
You can determine which users of your application are allowed to view the Mixpost UI by defining a gate check called
viewMixpost in your app/Providers/AppServiceProvider.php file.
public function boot()
{
\Illuminate\Support\Facades\Gate::define('viewMixpost', function ($user = null) {
return optional($user)->email === 'dima@inovector.com';
});
}Mixpost will redirect unauthorized users to the route name specified in the redirect_unauthorized_users_to_route key of the
Mixpost config file.
After performing all these steps, you should be able to visit the Mixpost UI at /mixpost.
composer testPlease see Releases for more information what has changed recently.
By participating in this project you agree to these conditions 👇
Please note that this project is a commercial product, and this repository is the lite version of Mixpost Pro. We work hard to offer the community the best free social media manager solution and please read this section carefully.
If you want to add a feature, it's better to open an issue before you start coding. It is important for us that features from the Lite version do not correlate with features from the Mixpost Pro. PRs with optimizations, bug fixes are welcome.
Please, be very clear on your commit messages and pull requests, empty pull request messages may be rejected.
When contributing code to Mixpost, you must follow the PSR-12 Coding Standard. The golden rule is: Imitate the existing Mixpost code.
Please review our security policy on how to report security vulnerabilities.
Mixpost is licensed under the MIT License, sponsored and supported by Inovector.