Postzyn By KentDevTools (Documentation)

Introduction — Postzyn By KentDevTools

Overview

Postzyn By KentDevTools (Programmed Bot) is a powerful automation application designed to synchronize content across your WordPress network directly from your computer. Unlike the standard plugin version, the Desktop application provides a robust interface for managing large-scale content pipelines, allowing you to fetch, clean, and publish articles to self-hosted WordPress sites with ease.

What You Need to Start

• Operating System: A computer running macOS 11+ or Windows 10+.
• Target Site: A self-hosted WordPress website (standard WordPress.com free plans are not supported).
• License: A valid Postzyn license key from KentDevTools.
• Connection: A stable internet connection for fetching feeds and communicating with the WordPress REST API.

How it Works

1. Source Input: You provide RSS or Atom feed URLs from your favorite content sources.
2. Scheduled Checks: Postzyn Desktop monitors these feeds based on your chosen interval (1, 5, 10, or 30 minutes).
3. Content Sanitization: The application automatically fetches new articles, removes unwanted clutter, and formats them for optimal SEO.
4. Automated Publishing: New posts are sent to your WordPress site complete with proper headings and metadata.
5. Media Handling: Featured images are automatically downloaded and attached to each post.
6. Branding: A customized footer containing your site name is added to every article to maintain brand consistency.

Support and Assistance

This guide is designed for users of all technical levels. If you encounter any issues during setup or operation, personal assistance is available through the KentDevTools support portal. We recommend starting with the Requirements section to ensure your environment is ready for deployment.

Requirements — Postzyn By KentDevTools

System Prerequisites

To run the Postzyn Desktop application, your computer and website must meet the following specifications:

• Operating System:
  • Mac: macOS 11 (Big Sur) or higher.
  • Windows: Windows 10 or Windows 11.
• Website Platform: A self-hosted WordPress installation on your own domain (e.g., mysite.com).
  • Note: Standard WordPress.com free plans (e.g., mysite.wordpress.com) are not supported as they do not allow the necessary REST API access.

Licensing

A valid license key is required to activate and use the application. If you do not have one, you can obtain it through the KentDevTools portal.

Plan	Sites Supported	Price
Starter	1 WordPress Site	10.99 one-time
Pro	3 WordPress Sites	15.99 one-time
Agency	Unlimited Sites	35.99 one-time

Connectivity

• Internet Connection: A stable connection is required for the application to monitor RSS feeds and communicate with your WordPress site’s API.
• REST API Access: Ensure your WordPress site does not have the REST API disabled by security plugins, as Postzyn Desktop uses this to publish your content.

Hosting Compatibility

Postzyn is compatible with most major hosting providers, including SiteGround, Kinsta, WP Engine, and Namecheap. Because the application runs on your local computer rather than the server, it avoids many of the common timeout or memory issues associated with server-side plugins.

Install on Mac — Postzyn By KentDevTools

Setup Environment

To run Postzyn on macOS, you need to set up a Python environment. This process is only required once during the initial installation.

1. Install Python 3.11: Open your Terminal and run the following command using Homebrew:brew install python@3.11(If you do not have Homebrew installed, visit brew.sh to get the installation command).
2. Install Tk: This is required for the application interface. Run:brew install python-tk@3.11
3. Install Dependencies: Navigate to your application folder and install the necessary libraries:cd ~/Desktop/postzyn-desktoppip3.11 install -r requirements.txt

Running the Application

Once the environment is set up, you can launch Postzyn at any time by following these steps:

1. Open the Terminal.
2. Navigate to the directory: cd ~/Desktop/postzyn-desktop
3. Execute the script: python3.11 main.py

Technical Notes

• Persistence: You do not need to repeat the installation steps. For future sessions, simply use the “Run Postzyn” command in your Terminal.
• Permissions: Ensure your terminal has the necessary permissions to read and write to the application folder so it can save your logs and configuration data.
• System Compatibility: Postzyn Desktop is optimized for macOS 11 (Big Sur) and later versions.

Install on Windows — Postzyn Desktop By KentDevTools

Installation Methods

Postzyn Desktop offers two ways to get started on Windows 10 or 11. You can use the pre-compiled executable for simplicity or run the application from the source code if you prefer a manual setup.

Method 1: Using the Executable (Recommended)

This is the fastest way to get Postzyn running on your Windows machine:

1. Extract the Files: Download and unzip the postzyn-desktop-windows.zip folder to your preferred location (e.g., your Desktop).
2. Locate the App: Navigate into the folder to find the dist\Postzyn\ directory.
3. Launch: Double-click Postzyn.exe.
4. Security Note: If Windows SmartScreen shows a warning, click More info → Run anyway. This is standard for new applications that are not yet in the Microsoft global database.

Method 2: Running from Source

If you are a developer or prefer using Python directly:

1. Install Python: Download Python 3.11 from python.org. Ensure you check the box “Add Python to PATH” during installation.
2. Install Dependencies: Open the Command Prompt, navigate to your project folder, and run:pip install -r requirements.txt
3. Launch: Start the application by running:python main.py

Initial Setup Tips

• License Key: Have your license key ready. You will be prompted to enter it the first time you launch the application.
• Folder Permissions: Make sure the folder where Postzyn is located has write permissions so it can save your logs and configuration files locally.
• System Tray: Once running, the application will manage your content in the background. You can check the live activity log to monitor the status of your synchronization.

SETUP:

Activate License — Postzyn By KentDevTools

Activation Process

Once you have installed Postzyn and launched the application for the first time, you will need to activate your license to unlock its full functionality. Follow these steps to complete the activation:

1. Locate Your Key: Find the license key sent to your email after purchase. It will typically follow this format: POSTZYN-PLAN-XXXXXX-XXXXXX-XXXXXX-XXXXXX.
2. Open Activation Screen: Launch the Postzyn application on your Mac or Windows computer.
3. Enter Credentials: Paste your license key into the designated input field.
4. Verification: Click the Activate License button. The application will connect to the KentDevTools servers to verify your credentials. Upon successful validation, a green confirmation message will appear displaying your current plan details.

Plan Limits

The number of WordPress sites you can manage depends on the specific plan you purchased:

Plan	WordPress Sites Supported
Starter	1 Site
Pro	3 Sites
Agency	Unlimited Sites

Important Considerations

• Usage Policy: Your license key is restricted to the number of sites defined by your plan. If you attempt to add more sites than your plan allows, the application will prompt you to upgrade.
• Security: Keep your license key private. It is tied to your account and is necessary for re-activating the application if you move to a new computer.
• Upgrading: If you find you need to manage more sites, you can upgrade your plan at any time through the KentDevTools website.

Add WordPress Site — Postzyn By KentDevTools

Overview

To begin synchronizing content, you must first connect Postzyn Desktop to your WordPress website. This connection is established using the secure WordPress REST API and an Application Password.

Preparation: Create an Application Password

Before setting up the site in the desktop application, you need to generate a dedicated password within WordPress:

1. Log in to your WordPress admin dashboard.
2. Navigate to Users → Profile (or Users → Your Profile).
3. Scroll down to the Application Passwords section.
4. Enter a name for the app (e.g., “Postzyn Desktop”) and click Add New Application Password.
5. Copy the generated password immediately, as it will only be shown once.

Connecting the Application

1. Open the Sites Tab: In Postzyn Desktop, click the Sites button in the sidebar.
2. Add New Site: Click the + Add Site button.
3. Enter Site Details:
   • Site Name: A nickname for your reference.
   • WordPress URL: Your full site address (e.g., https://mysite.com).
   • Username: Your WordPress login username (not your email address).
   • App Password: The password you generated in the previous step.
4. Verify Connection: Click the Test button. If successful, you will see a confirmation message.
5. Save: Click Save Site. This site is now active and ready for content synchronization.

Add RSS Sources — Postzyn By KentDevTools

Configuring Content Sources

Once your site is connected, you must define the RSS feeds that Postzyn will monitor for new articles.

1. Navigate to Sources: Click the Sources button in the sidebar.
2. Add Feed:
   • Source Name: A label for the feed (e.g., “Tech News”).
   • Feed URL: The direct RSS or Atom link (e.g., https://techcrunch.com/feed/).
   • Category: The WordPress category where you want these posts to be filed.
   • Max Posts: The maximum number of articles the app should fetch from this feed in a single run.
3. Activate: Ensure the feed is toggled to Active and click Save Source.

Recommended RSS Feeds

Source	Feed URL	Category
BBC Health	https://feeds.bbci.co.uk/news/health/rss.xml	Health
TechCrunch	https://techcrunch.com/feed/	Technology
NASA News	https://www.nasa.gov/rss/dyn/breaking_news.rss	Science
Reuters Business	https://feeds.reuters.com/reuters/businessNews	Business

Pro Tips for Performance

• Start Small: Begin with 2 to 3 sources and set the “Max Posts” to 5 each. This ensures the initial synchronization is fast and allows you to verify the formatting.
• Validation: If a feed fails to synchronize, verify the URL by opening it in a browser to ensure it displays valid XML code.
• Expansion: You can add more sources or increase the “Max Posts” limit once you have confirmed your settings and branding are appearing correctly on your site.

USING POSTZYN:

Dashboard — Postzyn By KentDevTools

Central Overview

The Dashboard provides a comprehensive look at your automation health and account status. It features several key data points to help you monitor your content network:

• Active Site: Displays the name of the WordPress site currently selected for synchronization.
• Active Sources: Shows the total number of RSS feeds currently enabled for the active site.
• Total Posts: A lifetime count of all articles successfully published across your network via the app.
• Sites: Indicates how many WordPress sites are currently connected to your Postzyn account.

Status Indicator & Activity Log

A prominent status badge in the top bar confirms the app’s operational state. When RUNNING (Green), Postzyn is actively monitoring your feeds. When STOPPED (Red), all automation is paused.

The Live Activity Log provides real-time, color-coded updates:

• Green (Checkmark): Post published successfully.
• Blue (Antenna): Checking a source feed.
• White (Magnifying Glass): A new article has been discovered.
• Yellow (Warning): Indicates a feed issue or minor warning.
• Red (Cross): Post failed to publish.
• Gray (Sleep): Waiting until the next scheduled run.

Run & Stop Controls — Postzyn By KentDevTools

Manual and Automated Management

The control panel allows you to dictate exactly when and how your content is fetched.

• Run Now: Clicking this button triggers an immediate scan of all active sources. Additionally, it establishes the automatic schedule, ensuring the app continues to check for new content every few minutes.
• Stop: The red Stop button pauses all background activity. No new posts will be published automatically while the app is in the STOPPED state.
• Clear Log: Use this to wipe the visible log history within the app interface. This action is purely cosmetic and does not delete your settings or previously published posts.

Operational Note

Postzyn only functions while the application is open on your computer. If the app is closed, all posting activity stops. To maintain constant 24/7 automation, the application must remain open.

Settings — Postzyn By KentDevTools

Automation & Content Configuration

The Settings menu allows you to fine-tune the publishing behavior of the application.

• Sync Interval: Set how often the app scans your feeds (1, 5, 10, or 30 minutes).
• Post Status: Choose between Publishing (live immediately) or Draft (requires manual review).
• Defaults: Assign a fallback category and a specific WordPress username to be used as the author for all synchronized posts.
• Content Sanitization: Toggle the Remove Author setting to automatically strip original bylines from the fetched articles.

Branding & Portability

• Branding Footer: When enabled, the app appends a professional footer with your Site Name and Site URL to every post.
• Export/Import: You can save your entire configuration to a JSON file on your Desktop. This allows you to restore your settings later or move your setup to a different computer effortlessly.

Analytics — Postzyn By KentDevTools

Performance Tracking

The Analytics screen provides visual insights into your content production and source efficiency.

• Summary Cards: Quick-view metrics for Total Posts, Posts Today, Posts This Week, and total Error counts.
• Daily Trends: A 14-day bar chart showing your publishing volume per day.
• Source Breakdown: A percentage-based chart illustrating which RSS sources are contributing the most content to your site.
• Data Export: You can click Export CSV to download your full posting history as a spreadsheet. This file is saved directly to your Desktop and can be opened in Excel or Google Sheets for further reporting.

FAQ:

FAQ — Postzyn By KentDevTools

Common Questions & Operations

• Can I review posts before they go live?Yes. In the Settings menu, change the Post Status to Draft. This saves all incoming articles to your WordPress dashboard for manual review, allowing you to edit or approve them before they are published to your audience.
• Which RSS feeds work best?While Postzyn is compatible with most standard XML feeds, sources like BBC, NASA, and Harvard Health are highly recommended for providing clean, well-formatted content that is easy to sanitize.
• What should I do if my license key says “Invalid”?Ensure you are copying the full key directly from your purchase email without any leading or trailing spaces. If the error persists, check your internet connection, as the app must reach the KentDevTools servers for verification.
• How do I update the application?Postzyn Desktop will automatically display a notification when a new version is released. You can download the latest version from the KentDevTools website. Your existing settings and license remain safe in your local config.json file during the update process.

Troubleshooting — Postzyn By KentDevTools

Resolving Common Issues

• Problem: “Connected Failed” when adding a site
  • Check Credentials: Verify that you are using your WordPress Username and the specific Application Password, not your standard login password.
  • REST API Status: Ensure your site’s REST API is not blocked by a security plugin (like Wordfence) or a maintenance mode plugin.
  • URL Format: Double-check that your WordPress URL includes the correct protocol (e.g., https://mysite.com).
• Problem: Posts are not appearing
  • App Status: Ensure the status badge says RUNNING.
  • Feed Validity: Open your RSS URL in a web browser; if it doesn’t display XML code, the feed link may be broken.
  • Keep App Open: Remember that Postzyn Desktop only synchronizes content while the application is actively running on your computer.
• Problem: Windows Defender/Security WarningsIf Windows prevents the application from launching:
  1. Click More Info and then Run Anyway.
  2. Alternatively, add a folder exception in Windows Security settings for the postzyn-desktop folder.
  3. If security settings are extremely strict, you can run the app directly from the source code using Python 3.11.

Personal Support

If you encounter an error that is not covered here, you can contact the support portal at kentdevtools.com/contact. Providing a screenshot of the error or the log entry will help the team resolve your issue quickly, typically within 24 hours.